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PREFACE 



This manual describes how to program the MCS™-51 single-chip microcomputers in 
assembly language. It also describes the operating instructions for the MCS-51 
Macro Assembler. 

The term "MCS-51" refers to an entire family of single-chip microcomputers, all of 
which have the same basic processor design. They include: 

• 8051— the 8x51 processor with 4K bytes ROM. It is manufactured by Intel with 
ROM memory pre-programmed. 

• 8031— the 8x51 processor with no ROM on-chip. 

• 8751— the 8x51 processor with 4K bytes EPROM. The 8751 can be programmed 
and erased many times by the user. 

Throughout this manual when we wish to refer to a specific chip, but also point out 
something that applies to the entire family, we speak of the 8051. For software pur- 
poses, these processors are equivalent. 

This book is intended as a reference, but it contains some instructional material as 
well. It is organized as follows: 

• Chapter 1— Introduction, describes assembly language programming and 
provides an overview of the 8051 hardware. 

• Chapter 2— Operands and Expressions, describes each operand class and 
discusses absolute and relocatable expressions. 

• Chapter 3— Instruction Set, completely describes the operation of each 
instruction in alphabetical order. 

• Chapter 4— Directives, describes how to define symbols and how to use all 
directives. 

• Chapter 5— Macros, defines and describes the use of the Macro Processing 
Language. 

• Chapter 6— Assembler Operation and Control, describes how to invoke the 
assembler and how to control assembler operation. 

• Chapter 7— Assembler Output: Error Messages and Listing File Format, 
describes how to interpret error messages and the listing file. 

Before you program one of the MCS-51 microcomputers, you should read the 
MCS-51 User's Manual, Order Number 121517. 



Related Literature 

To help you use this manual, you should familiarize yourself with the following 
manuals: 

• MCS-51 Utilities User's Guide, Order Number 121737 (describes the RL51 
Relocator and Linker process) 

• MCS-51 Family of Single-Chip Microcomputers User's Manual, Order Number 
121517 

• 75/5-/7 User's Guide, Order Number 9800306 

• MCS-51 Macro Assembly Language Pocket Reference, Order Number 
9800935 



• MCS-S1 Assembler and Utilities Pocket Reference, Order Number 121817 

• ICE-SI In-Circuit Emulator Operating Instructions for ISIS-II Users, Order 
Number 9801004 

• Universal PROM Programmer User's Manual^ Order Number 98008 19 

• Universal PROM Programmer Reference Manual, Order Number 98001 33 
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CHAPTER 1 
INTRODUCTION 



This manual describes the MCS™-51 Macro Assembler and explains the process of 
developing software in assembly language for the MCS-51 family of processors. The 
8051 is the primary processor described in this manual. 

Assembly language programs translate directly into machine instructions which 
instruct the processor as to what operation it should perform. Therefore the 
assembly language programmer should be familiar with both the microcomputer 
architecture and assembly language. This chapter presents an overview of the 
MCS-51 Macro Assembler and how it is used, as well as a brief description of the 
8051 architecture and hardware features. 



What is an Assembler? 

An assembler is a software tool — a program — designed to simplify the task of 
writing computer programs. It performs the clerical task of translating symbolic 
code into executable object code. This object code may then be programmed into 
one of the MCS-51 processors and executed. If you have ever written a computer 
program directly in machine-recognizable form, such as binary or hexadecimal 
code, you will appreciate the advantages of programming in a symbolic assembly 
language. 

Assembly language operation codes (mnemonics) are easily remembered (MOV for 
fnove instructions, ADD for addition). You can also symbolically express addresses 
and values referenced in the operand field of instructions. Since you assign these 
names, you can make them as meaningful as the mnemonics for the instructions. 
For example, if your program must manipulate a date as data, you can assign it the 
symbolic name DATE. If your program contains a set of instructions used as a tim- 
ing loop ( a set of instructions executed repeatedly until a specific amount of time 
has passed), you can name the instruction group TIMER LOOP. 

The assembly program has three constituent parts: 

Machine instructions 
Assembler directives 
Assembler controls 

A machine instruction is a machine code that can be executed by the machine. 
Detailed discussion of the machine instructions is presented in Chapter 3. 

Assembler directives are used to define the program structure and symbols, and 
generate non-executable code (data, messages, etc.). See Chapter 4 for details on all 
of the assembler directives. 

Assembler controls set the assembly modes and direct the assembly flow. Chapter 6 
contains a comprehensive guide to all the assembler controls. 



How to Develop a Program 

ASM51 enables the user to program in a modular fashion. The following paragraphs 
explain the basics of modular program development. 
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The Advantages of Modular Programming 

Many programs are too long or complex to write as a single unit. Programming 
becomes much simpler when the code is divided into small functional units. Modular 
programs are usually easier to code, debug, and change than monolithic programs. 

The modular approach to programming is similar to the design of hardware which 
contains numerous circuits. The device or program is logically divided into "black 
boxes" with specific inputs and outputs. Once the interfaces between the units have 
been defined, detailed design of each unit can proceed separately. 



Efficient Program Development 

Programs can be developed more quickly with the modular approach since small 
subprograms are easier to understand, design, and test than large programs. With 
the module inputs and outputs defined, the programmer can supply the needed input 
and verify the correctness of the module by examining the output. The separate 
modules are then linked and located into one program module. Finally, the com- 
pleted module is tested. 



Multiple Use of Subprograms 

Code written for one program is often useful in others. Modular programming 
allows these sections to be saved for future use. Because the code is relocatable, 
saved modules can be linked to any program which fulfills their input and output 
requirements. With monolithic programming, such sections of code are buried 
inside the program and are not so available for use by other programs. 

fease of Debugging and Modifying 

Modular programs are generally easier to debug than monolithic programs. Because 
of the well-defined module interfaces of the program, problems can be isolated to 
specific modules. Once the faulty module has been identified, fixing the problem is 
considerably simpler. When a program must be modified, modular programming 
simplifies the job. You can link new or debugged modules to the existing program 
with the confidence that the rest of the program will not be changed. 



MCS-5 1 Modular Program Development Process 

This section is a brief discussion of the program development process with the 
relocatable MCS-51 assembler (ASM51), Linker/Relocator (RL51), and code con- 
vertion programs. 

Segments, Modules, and Programs 

In the initial design stages, the tasks to be performed by the program are defined, 
and then partitioned into subprograms. Here are brief introductions to the kinds of 
subprograms used with the MCS-51 assembler and linker/relocator. 

A segment is a block of code or data memory. A segment may be relocatable or 
absolute. A relocatable segment has a name, type, and other attributes. Segments 
with the same name, from different modules, are considered part of the same seg- 
ment and are called "partial segments." Partial segments are combined into 
segments by RL51 . An absolute segment has no name and cannot be combined with 
other segments. 
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A module contains one or more segments or partial segments. A module has a name 
assigned by the user. The module definitions determine the scope of local symbols. 
An object file contains one or more modules. You can add modules to a file by 
simply appending another object file to that file (e.g., COPYfile1,file2 TO file3). 

A program consists of a single absolute module, merging all absolute and 
relocatable segments from all input modules. 



Program Entry and Edit 

After the design is completed, the source code for each module is entered into disk 
file using a text editor. When errors are detected in the development process, the text 
editor may be used to make corrections in the source code. 



Assembly 

The assembler (ASM51) translates the source code into object code. The assembler 
produces an object file (relocatable, when at least one input segment is relocatable, 
or absolute), and a listing file showing the results of the assembly. (Figure 1-1 sum- 
marizes the assembly and the link and relocate outputs.) When the ASM51 invoca- 
tion contains the DEBUG control, the object file also receives the symbol table and 
other debug information for use in symbolic debugging of the program. 



Object File. The object file contains machine language instructions and data that 
can be loaded into memory for execution or interpretation. In addition, it contains 
cpntrol information governing the loading process. 

The assembler can produce object files in relocatable object code format. However, 
if the module contains only absolute segments and no external references, the object 
file resulting from assembly is absolute. It can be loaded without the need of the 
RLSlpass. 
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Figure 1-1 . Assembler and Linker/Relocator Outputs 
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Listing File. The listing file provides a permanent record of both the source pro- 
gram and the object code. The assembler also provides diagnostic messages in the 
listing file for syntax and other coding errors. For example, if you specify a 16-bit 
value for an instruction that can only use an 8-bit value, the assembler tells you that 
the value exceeds the permissible range. Chapter 7 describes the format of the listing 
file. In addition, you can also request a symbol table to be appended to the listing. 
The symbol table lists all the symbols and their attributes. 

Relocation and Linkage 

After assembly of all modules of the program, RL51 processes the object module 
files. The RL51 program assigns absolute memory locations to all the relocatable 
segments, combining segments with the same name and type. RL51 also resolves all 
references between modules. RL51 outputs an absolute object module file with the 
completed program, and a summary listing file showing the results of the 
link/relocate process. 

Conversion to Hexadecimal Format 

The absolute object code produced by RL51 can be programmed into memory and 
executed by the target processor without further modification. However, certain 
MCS-5 1 support products (such as SDK-51) require the hexadecimal object code 
format. For use with these products, the absolute object file must be processed by 
the OBJHEX code conversion program. Refer to the 1S1S-11 System User's Guide 
(9800306). 

Keeping Track of Files 

It is convenient to use the extensions of filenames to indicate the stage in the process 
represented by the contents of each file. Thus, source code files can use extensions 
like .SRC or .A51 (indicating that the code is for input to ASM51). Object code files 
receive the extension .OBJ by default, or the user can specify another extension. 
Executable files generally have no extension. Listing files can use .LST, the default 
extension given by the assembler. RL51 uses .M51 for the default summary listing 
file extension. 

Use caution with the extension .TMP, as many ISIS-II utilities create temporary files 
with this extension. These utilities will overwrite your file if it has the same name and 
extension as the temporary files they create. 



Writing, Assembling, and Debugging an MCS-51 Program 

There are several steps necessary to incorporate an MCS-51 microcomputer in your 
application. The flow chart in Figure 1-2 shows the steps involved in preparing the 
code. If you are developing hardware for your application in addition to the soft- 
ware, consult the MCS-51 User's Manual. 

Figure 1-3 shows an assembly listing of a sample program. The assembler was 
invoked by: 

-ASM51 :F1:DEM0.A51 

ISIS-II MCS-51 MACRO ASSEMBLER, V2.0 

ASSEMBLY COMPLETE, NO ERRORS FOUND 
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TEXT 
EDITOR 



J[ SOURCE I ^ 

^i modules n* 



ASM51 
ASSEMBLER 



__Aelocatable\_^ 

T*l OBJECT r-*' 

V MODULES / 



(FOR ABSOLUTE PROGRAMS) 



□ 

o 



INTEL DEVELOPMENT TOOLS 
AND OTHER PRODUCTS 



USER-CODED 
SOFTWARE 




SDK-51 

SYSTEM 

DESIGN 

KIT 



Figure 1-2. MCS-51 Program Development Process 



MCS-51 MACRO ASSEMBLER 



3051-3ASED MONITOR 



ISIS-II MCS-51 MACRO ASSEMBLER V2.0 
OBJECT MODULE PLACED IN :F1:DEMQ.03J 
ASSEMBLER iNVdKEO SY: ASM51 :M tD.-MO. A51 



LOC OBJ 



0000 
000A 



0000 020000 



0000 900000 F 
0003 120000 F 
0006 020000 F 



0000 1A 

0001 38303531 
0005 20424153 
0009 45442040 
0000 4F4E4954 
0011 4F522C20 
0015 56312E30 
0019 00 

001A OA 
001 A 



LINE 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 



23 

24 
25 



SOURCE 



STITLE(8051~BASED MONITOR) 

;The main module of an 8051-based Monitor 



^Symbol definitions 

PROG.S SEGMENT CODE 
TABLE. S SEGMENT CODE 
CR EQU 13 
LF EQU 10 



;Contains the exectutable program 
'Contains tables and other constant data 
;Carriage-Return character (ASCII) 
;Line-Feed character (ASCII) 



EXTRN CCDE(C3NS0L_0UT' MONITOR) 



^Defined elsewhere 



rThe main program 

CSEG AT 
JMP START 



START: 



RSEG 

MOV 

CALL 

JMP 



RSEG 
SIGNON: OB 



PROG.S 

0PTR'#SIGN0N 

CONSOL.OUT 

MONITOR 



;Skip interrupt vectors if any 

;print signon message 
#Enter the monitoring loop 



TABLETS 

LEN'*8051-BASED MONITOR, V1.0% CR# LF 



LEN 



EQU 



ENO 



S-SIGNON-1 



'Compute message length 



Figure 1-3. Sample Program Listing 



1-5 



Introduction 



MCS-51 



MCS-51 MACRO ASSEMBLER 8051-BASED MONITOR 
SYMBOL TABLE LISTING 



N A M E 



TYPE 



VALUE 



ATTRIBUTES 



CONSOL.OUT C AOOR 







EXT 




CR . . . 


NUMB 


OOOOri 


A 






LEN. . . 


NUMB 


001AH 


A 






LP . . • 


NUMB 


OOOAH 


A 






MONITOR. 


. C ADOR 


— - 




EXT 




PROG.S . 


. C SEG 


0009H 






RSL=UNIT 


SIGNON • 


. C AOOR 


OOOOH 


R 




SEG=TABLE.S 


START. . , 


. C AODR 


OOOOH 


R 




SEG^PROG.S 


TABLETS. « 


. C SEG 


001BH 






REL=UNIT 



REGISTER BANKCS) USED: 0/ TARGET MACHINE (S) : 8051 
ASSEMBLY COMPLETE, NO ERRORS FOUND 



Figure 1-3. Sample Program Listing (Cont'd.) 



Figure 1-3 shows the listing file of a simple module which is part of a larger program 
not shown here. A larger example is provided in Appendix H. 

The next step after the program is assembled by ASM51 is to combine all modules 
into one program using RL5.1 . RL51 produces a summary listing file consisting of a 
memory map and a symbol table. (Refer to the MCS-51 Utilities User's Guide, 
,421737.) 

The next step in debugging your code is to program it into an EPROM 8751 and test 
it in a prototype environment. (Further testing could be done via ICE-51.) To pro- 
gram your code into an 8751, you must have a UPP connected to your Intellec 
system. For a complete description of how to use UPP and UPM, see Universal 
PROM Programmer Reference Manual, order number 9800133 and Universal 
PROM Programmer User's Manual, order number 9800819. 

Hardware Overview 

The 8051 is a high-density microcomputer on a single chip. Its major features are: 

• Resident 4K bytes of ROM or EPROM program memory (no program memory 
resident on 8031), expandable to 64K bytes 

• Resident 128 bytes of RAM memory, which includes four banks of 8 
general-purpose registers and a stack for subroutine and interrupt routine calls 

• 64K bytes of external RAM address space 

• 16-bit Program Counter giving direct access to 64K bytes of memory 

• 8-bit stack pointer that can be set to any address in on-chip RAM 

• Two programmable 16-bit timers/counters 

• Programmable full duplex serial I/O ports 

• Four 8-bit bidirectional parallel I/O ports 

• Timer and I/O interrupts with two levels of priority 

• 111 instructions with 51 basic functions (including memory to memory move) 

• Boolean functions with 128 software flags, numerous hardware flags, and 12 
bit-operand instructions 
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• One microsecond instruction cycle time 

• Arithmetic and logic unit that includes add, subtract, multiply, and divide 
arithmetic functions, as well as and, or, exclusive or, and complement logic 
functions. 

Figure 1-4 is a block diagram of the 8051 processor. It shows the data paths and 
principal functional units accessible to the programmer. 
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Figure 1-4. 8051 Block Diagram 
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Memory Addresses 

The 805 1 has five address spaces: 

• Code address space— 64K, of which 4K are on-chip (except for the 8031 which 
has no on-chip ROM). 

• Directly addressable internal data address space— 128 bytes of RAM (0 - 127) 
and 128-byte hardware register address space (128 - 255, only 20 addresses are 
used); accessible by direct addressing. 

• Indirectly addressable internal data address space— 128 bytes (0 - 127), all of 
which is accessible by indirect addressing. 

• External data address space — up to 64K of off -chip memory added by the user. 

• Bit address space — shares locations accessible in the data address space; 
accessible by direct addressing. 

The code address space, internal data address space (including both the directly and 
indirectly addressable space and the bit address space), and external data space cor- 
respond to three physically distinct memories, and are addressed by different 
machine instructions. This is an important distinction that is a key to understanding 
how to program the 805 1 . 

When you specify in an operand to an instruction a symbol with the wrong attribute, 
ASM-51 generates an error message to warn you of the inconsistency. Chapters 2 
and 3 show what segment type attribute is expected in each instruction, and Chapter 
4 describes how to define a symbol with any of the segment type attributes. 

Figure 1-5 shows the code address space (usually ROM), and the external data 
address space (usually RAM). Off-chip ROM and RAM can be tailored to use all or 
part of the address space to better reflect the needs of your application. You can 
access data in ROM and off-chip RAM with the MOVC and MOVX instructions 
respectively. 



OFF-CHIP 
ROM 



ON-CHIP 
ROM 



OFF-CHIP 
RAM 



CODE 

ADDRESS 

SPACE 



EXTERNAL DATA 
ADDRESS SPACE 



Figure 1-5. MCS-51 Code Address Space and 
External Data Address Space 
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To the programmer, there is no distinction between on-chip and off -chip code. The 
16-bit program counter freely addresses on- and off-chip code memory with no 
change in instruction fetch time. 

Figure 1-6 shows the data address space containing the bit address space. The data 
address space contains four banks of general-purpose registers in the low 32 bytes (0 
- 1FH). In addition to the 128 bytes of RAM, the 805 l's hardware registers are map- 
ped to data addresses. The addresses from 128 to 255 are reserved for these registers, 
but not all of those addresses have hardware registers mapped to them. These 
reserved addresses are unusable. 

When programming the 8051 and using indirect addressing, the user can access 
on-chio RAM from to 127. 



DIRECT 
ADDRESSING 



INDIRECT 
ADDRESSING 



DIRECTLY/INDIRECTLY 

ADDRESSABLE j 
ON-CHIP A 
RAM 



HARDWARE 
REGISTER 
MAPPING 



NOT 
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4 REGISTER BANKS 



255 
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8 STACK DEFAULT 




Figure 1-6. MCS-51 Data Address Space and 
Bit Address Space 
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Data Units 

The 8051 manipulates data in four basic units—bits, nibbles (4 bits), bytes, and 
words (16 bits). 

The most common data unit used is a byte; all of the internal data paths are 8 bits 
wide, and the code memory, the data memory, and the external data memory store 
and return data in byte units. However, there are many instructions that test and 
manipulate single bits. Bits can be set, cleared, complemented, logically combined 
with the carry flag, and tested for jumps. The nibble (BCD packed digit) is less 
commonly used in the 805 1. but BCD arithmetic can be performed without con- 
version to binary representation. 
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Figure 1-7. MCS-51 Data Units 
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Instructions that use 16-bit addresses deal with the Data Pointer (DPTR, a 16-bit 
register) and the Program Counter (jumps and subroutine calls). However, with the 
add with carry (ADDC) and subtract with borrow (SUBB) instructions, software 
implementation of 16-bit arithmetic is relatively easy. 



Arithmetic and Logic Functions 

The arithmetic functions include: 

• ADD— signed 2's complement addition 

• ADDC— signed 2's complement addition with carry 

• SUBB— signed 2's complement subtraction with borrow 

• DA— adjust 2 packed BCD digits after addition 

• MUL— unsigned integer multiplication 

• DIV— unsigned integer division 

• INC — signed 2's complement increment 

• DEC— signed 2's complement decrement 

The accumulator receives the result of ADD, ADDC, SUBB, and DA functions. The 
accumulator receives partial result from MUL and DIV. DEC and INC can be 
applied to all byte operands, including the accumulator. 

The logical functions include: 

• ANL— logical and on each bit between 2 bytes or 2 bits 

• CPL — logical complement of each bit within a byte or a single bit 

• ORL— logical or on each bit between 2 bytes or 2 bits 

• XRL— logical exclusive or on each bit between 2 bytes 
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The accumulator usually receives the result of the byte functions, and the carry flag 
usually receives the result of the bit functions, but some instructions place the result 
in a specified byte or bit in the data address space. 

The instructions shown above are described in Chapter 3. 



General-Purpose Registers 

The 8051 has four banks of eight 1-byte general-purpose registers. They are located 
in the first 32 bytes of on-chip RAM (00H - 1FH). You can access the registers of the 
currently active bank through their special assembler symbols (R0, Rl, R2, R3, R4, 
R5, R6, and R7). To change the active bank you modify the register bank select bits 
(RSO and RSI) contained in the program status word (PSW, described in table 1-3). 
Table 1-1 below shows the bank selected for all values of RSO and RSI. 



Table 1-1 . Register Bank Selection 



RS1 


RSO 


Bank 


Memory Locations 





1 
1 




1 



1 



1 
2 
3 


00H— 07H 
08H— OFH 
10H— 17H 
18H-1FH 



Registers RO and Rl can be used for indirect addressing within the on-chip RAM. 
fiach register is capable of addressing 256 bytes but the indirect addressing is limited 
by the physical range of the internal RAM. RO and Rl also can address the external 
data space. 



The Stack 

The stack is located in on-chip RAM. It is a last-in-first-out storage mechanism used 
to hold the Program Counter during interrupts and subroutine calls. You can also 
use it to store and return data, especially the PSW, with the POP and PUSH instruc- 
tions. The Stack Pointer contains the address of the top of the stack. 

The Stack Pointer (SP) is an 8-bit register that may contain any address in on-chip 
RAM memory. However, on the 8051 it should never exceed 127. If it does, all data 
pushed is lost. A pop, when the SP is greater than 127, returns invalid data. 

The SP always contains the address of the last byte pushed on the stack. On power- 
up (Reset) it is set to 07H, so the first byte pushed on the stack after reset will be at 
location 08H. This location is compatible with the 8048's stack. Most programs 
developed for the 8051 will reset the bottom of the stack by changing the contents of 
the SP before using the stack, because 08H-1FH is the area reserved for several of 
the 805 Ts general-purpose-regrster banks. The following instruction causes the next 
byte pushed on the stack to be placed at location 100. 



MOVSP,#99 



; Initialize stack to start at location 100 
; The hardware increments the SP 
; BEFORE a push 
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Symbolically Addressable Hardware Registers 

Each programmable register is accessible through a numeric data address, but the 
assembler supplies a predefined symbol that should be used instead of the register's 
numeric address. Table 1-2 identifies each hardware register, its numeric address, 
and its predefined symbol. 

Table 1 -2. Symbolically Addressable Hardware Registers for the 805 1 



Predefined 
Symbol 


Data 
Address 


Meaning 


ACC 


EOH 


ACCUMULATOR (Data address of A) 


B 


FOH 


MULTIPLICATION REGISTER 


DPH 


83H 


DATA POINTER (high byte) 


DPL 


82H 


DATA POINTER (low byte) 


IE 


A8H 


INTERRUPT ENABLE 


IP 


B8H 


INTERRUPT PRIORITY 


P0 


80H 


PORTO 


P1 


90H 


PORT1 


P2 


AOH 


PORT 2 


P3 


BOH 


PORT 3 


PSW 


DOH 


PROGRAM STATUS WORD 


SBUF 


99H 


SERIAL PORT BUFFER 


SCON 


98H 


SERIAL PORT CONTROLLER 


SP 


81H 


STACK POINTER 


TCON 


88H 


TIMER CONTROL 


THO 


8CH 


TIMER (high byte) 


TH1 


8DH 


TIMER 1 (high byte) 


TLO 


8AH 


TIMER (low byte) 


TL1 


8BH 


TIMER 1 (low byte) 


TMOD 


89H 


TIMER MODE 



The predefined symbols given in table 1-2 stand for the on-chip data addresses of the 
hardware registers. In many cases the only access to these registers is through these 
data addresses. However, some of the registers have an identity both as a special 
assembler symbol and as a data address symbol (e.g., both "ACC" and "A" stand 
for the accumulator), but even though these symbols may be semantically the same, 
they are syntactically different. For example, 

ADDA,#27 

is a valid instruction to add 27 to the contents of the accumulator, but 

ADD ACC,#27 

is invalid and will cause an error, because there is no form of ADD taking a data 
address as the destination (ACC specifies a data address). The differences become 
even more subtle in some assembly instructions where both symbols are valid but 
assemble into different machine instructions: 



MOV A,#27 
MOV ACC,#27 



; assembles into a 2 byte instruction 
; assembles into a 3 byte instruction 
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Chapter 2 describes the syntax for all instruction operands, and Chapter 3 describes 
the operands expected in each instruction. 

Because the hardware registers are mapped to data addresses, there is no need for 
special I/O or control instructions. For example, 

MOVA,P2 

moves a copy of the input data at Port 2 to the accumulator. To output a character 
on the Serial I/O port (after preparing SCON), simply move the character into the 
Serial port buffer (SBUF): 

MOVSBUF,#'?' 



Bit Addressing 

Many of the hardware control registers are also bit addressable. The flags contained 
in them can be accessed with a bit address as well as through the byte address shown 
above. One way to do this is through the bit selector ("."). For example, to access 
the bit in the accumulator, you might specify ACC.O. 

Bit addressing allows the same simplicity in testing and modifying control and status 
flags as was shown above with addressable registers. For example, to start Timer 
running, set the run flag to 1 via its bit address (SETB TCON.4). 

Throughout the remainder of this chapter, several programmable, features, includ- 
ing predefined bit addresses of status and control flags, are discussed. To use these 
features, you simply modify the corresponding address as if it were a RAM location. 

The Program Status Word 

The Program Status Word (PSW) contains several status bits that reflect the state of 
the 8051. Figure 1-8 shows the predefined bit address symbol, the bit position, and 
meaning of each bit in the PSW. 



PSW 
CARRY FLAG RECEIVES CARRY OUT 
PROM BIT 7 OF ALU OPERANDS 



AUXILIARY CARRY FLAG RECEIVES 

CARRY OUT FROM BIT 3 OF 

ADDITION OPERANDS 

PSW.5 ■ 
GENERAL PURPOSE STATUS FLAG 



,_t 



PSW.4 
REGISTER BANK SELECT BIT 1 



PSW.O 

PARITY OF ACCUMULATOR SET 
BY HARDWARE TO 1 IF IT CONTAINS 
AN ODD NUMBER OF 1's; OTHERWISE 
IT IS RESET TO 

- PSW.1 
USER DEFINABLE FLAG 



- PSW .2 
OVERFLOW FLAG SET BY 
ARITHMETIC OPERATIONS 



- PSW.3 
REGISTER BANK SELECT BIT 



Figure 1-8. Bit Descriptions of Program Status Word 
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Timer and Counter 

The 8051 has two independently programmable timers. They feature a 16-bit 
counter and are controlled by 2 registers, timer mode (TMOD) and timer control 
(TCON). Figure 1-9 shows the predefined bit address symbols, the positions and 
meanings of the bits in TCON. (For a complete description of the timer see the 
MCS-51 User's Manual.) 



TCON 
TIMER 1 OVERFLOW FLAG 



TCON.6 - 
TIMER 1 RUN CONTROL BIT 



,_J 



TRO 



TCON. 5 . 
TIMER OVERFLOW FLAG 



TCON.4 ■ 
TIMER RUN CONTROL BIT 



IE1 



»E0 ITO 



TCON.O 

INTERRUPT TYPE CONTROL BIT 



TCON.1 

INTERRUPT EDGE FLAG 



. TCON.2 
INTERRUPT 1 TYPE CONTROL BIT 



■ TCON.3 
INTERRUPT 1 EDGE FLAG 



Figure 1-9. Bit Descriptions of TCON 



I/O Ports 

The 8051 has 4 8-bit I/O ports; each bit in the ports corresponds to a specific pin on 
the chip. All four ports are buffered by a port latch, and they are addressable 
through a data address (as a byte) or 8 bit addresses (as a set of bits). As noted 
earlier, this removes the need for special I/O instructions. The numeric data address 
and the predefined symbol for each port is shown below: 



Port 



Predefined 
Symbol 



Data 
Address 



PO 
P1 
P2 
P3 



80H 
90H 
AOH 
BOH 



Port and Port 2 are used for external program and external data addressing. Port 
also receives the input data from off-chip addressing. If off-chip memory is not 
implemented, then ports and 2 are bidirectional I/O ports. Port 1 is a general pur- 
pose bidirectional I/O port. 

Port 3 contains the external interrupt pins, the external timer, the external data 
memory read and write enables, and the serial I/O port transmit and receive pins. 
The bits that correspond to these pins are individually addressable via predefined bit 
address symbols. Figure 1-10 shows the meaning of each bit, its position in Port 3, 
and its predefined bit address symbol. 

If the external interrupts, external data addressing, and serial I/O features of the 
8051 are not used, Port 3 can function as a bidirectional I/O port. 
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READ DATA FOR EXTERNAL MEMORY 



WRITE DATA FOR EXTERNAL MEMORY 



TIMER/COUNTER 1 EXTERNAL FLAG 



TIMER/COUNTER EXTERNAL FLAG 



TXD RXDj 



P3.0 

SERIAL PORT RECEIVE PIN 



• P3.1 
SERIAL PORT TRANSMIT PIN 



-P3.2 
INTERRUPT INPUT PIN 



• P3 3 
INTERRUPT 1 INPUT PIN 



Figure 1-10. Bit Descriptions for Port 3 



937-9 



Serial I/O Port 

The serial I/O port permits I/O expansion using UART protocols. The serial I/O 
port is controlled by Serial Port Controller (SCON), a register that is both bit 
addressable and byte addressable. Figure 1-11 shows the predefined bit address 
symbols, positions and meanings of the bits in SCON. For complete details of Serial 
I/O port control see the MCS-51 User's Manual. 



SCON 
SERIAL MODE CONTROL BIT 



SCON.6 
SERIAL MODE CONTROL BIT 1 



,-i 



SCON. 5 
SERIAL MODE CONTROL BIT 2 



SCON.4 
RECEIVER ENABLE 



SMO SM1 SM2 REN TB8 RB8 



Tl I Bl I 



t_ 



SCON.O 

RECEIVE INTERRUPT FLAG 



• SCON.1 
TRANSMIT INTERRUPT FLAG 



SCON. 2 
RECEIVE BIT 8 



SCON.3 
TRANSMIT BIT 8 



Figure 1-11. Bit Descriptions for Serial Port Control 



Interrupt Control 

There are two registers that control timer and I/O interrupts and priorities. They are 
IE (Interrupt Enable) and IP (Interrupt Priority). When the interrupt enable bit for 
a device is 1, it can interrupt the processor. The 8051 does not respond to an 
interrupt until the instruction being executed has been completed (this can be as long 
as 4 cycles). 

When it does respond, the 805 Ts hardware disables interrupts of the same or lesser 
priority and makes a subroutine call to the code location designated for the inter- 
rupting device. Typically, that location contains a jump to a longer service routine. 
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The instruction RETI must be used to return from a service routine, in order to 
re-enable interrupts. The reserved locations, the predefined labels, and the 
associated interrupt devices are listed below. These labels may be used to aid the 
placement of I/O routines in code memory. 



Predefined 




Label 


Location 


RESET 


00H 


EXTIO 


03H 


TIMERO 


OBH 


EXTI1 


13H 


TIMER1 


1BH 


SINT 


23H 



Interrupting Device 

Power on Reset (First instruction executed on power up.) 

External interrupt 

Timer 

External interrupt 1 

Timer 1 

Serial I/O port 



The 8051 has two levels of interrupt priority (0 and 1). Figure 1-12 shows the 
predefined bit address symbol, the position and the device associated with each bit 
contained in IE and IP. A level 1 priority device can interrupt a level service 
routine, but a level interrupt will not affect a level 1 service routine. Interrupts on 
the same level are disabled. 



RESERVED 



IP.7 J 



IP.6 - 
RESERVED 



IP.5 - 
RESERVED 



PRIORITY OF SERIAL PORT INTERRUPT 



PS PT1 PX1 PTO PXO 



> IP.O 



PRIORITY OF EXTERNAL INTERRUPT 



PRIORITY OF TIMER INTERRUPT 



PRIORITY OF EXTERNAL INTERRUPT 1 



PRIORITY OF TIMER 1 INTERRUPT 



Interrupt Priority 



En 



IE.7 
ENABLE ALL INTERRUPTS 



IE. 6 ■ 
RESERVED 



IE5 ■ 
RESERVED 



ENABLE SERIAL PORT INTERRUPT 



EX1 ETO EXO I 



1_, 



ENABLE EXTERNAL INTERRUPT 



ENABLE TIMER INTERRUPT 



ENABLE EXTERNAL INTERRUPT 1 



• IE.3 
ENABLE TIMER 1 INTERRUPT 



Interrupt Enable 



Figure 1-12. Bit Descriptions for Interrupt Enable and Interrupt Priority 
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Reset 

On reset all of the registers in the 8051 assume an initial value. Table 1-3 shows these 
initial values. This will always be the state of the chip when your code begins 
execution. You can use these initial values or reinitialize them as necessary in your 
program. 



Table 1-3. State of the 8051 after Power-up 



Register 


Value 


Accumulator 


00H 


Multiplication Register 


00H 


Data Pointer 


0000H 


Interrupt Enable 


00H 


Interrupt Priority 


00H 


PortO 


OFFH 


Portl 


OFFH 


Port 2 


OFFH 


Port 3 


OFFH 


Program Counter 


0000 H 


Program Status Word 


00H 


Serial Port Control 


00 H 


Serial I/O Buffer 


undefined 


Stack Pointer 


07H 


Timer Control 


00H 


Timer Mode 


00H 


Timer Counter 


0000H 


Timer 1 Counter 


0000H 



NOTE 

The PC is always set to on reset, thus the first instruction executed in a 
program is at ROM location 0. The contents of RAM memory is unpre- 
dictable at reset. 
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CHAPTER 2 
OPERANDS AND EXPRESSIONS 



This chapter discusses the operand types used by ASM51. It describes their use and 
some of the ways you can specify them in your program. The latter part of the 
chapter deals with expressing numbers and using expressions. 

There are two terms used throughout this chapter that require some definition: 
Assembly-time expressions and RL-time expressions. Assembly-time expressions are 
those expressions evaluated at assembly; they are absolute expressions. RL-time 
expressions are those evaluated at the time of relocation; they are relocatable expres- 
sions that are made absolute by RL5 1 . 



Operands 

The general form of all instruction lines is as follows: 

[label:] Mnemonic [operand] [.operand] [.operand] [;comment] 

The number of operands and the type of operands expected depend entirely on the 
mnemonic. Operands serve to further define the operation implied by a mnemonic, 
and they identify the parts of the machine affected by the instruction. 

All operands fall into one of six classes: 

• Special Assembler Symbols 

• Indirect Addresses 

• Immediate Data 

• Data Addresses (on-chip) 

• Bit Addresses 

• Code Addresses 

A special assembler symbol is a specific reserved word required as the operand in an 
instruction. 

Indirect addresses use the contents of a register to specify a data address. 

The remaining operand types (immediate data, data addresses, bit addresses, and 
code addresses) are numeric expressions. They may be specified symbolically, but 
they must evaluate to a number. If the expression can be evaluated completely at 
assembly time, it is called an absolute expression; if not, it is called a relocatable 
expression. The range permitted for a numeric operand depends on the instruction 
with which it is used. The operand can be made up of predefined or user-defined 
symbols, numbers, and assembly-time operators. 

As described in Chapter 1, there are five address spaces on the 8051. The 
corresponding segment type is given in parentheses. 

• Directly addressable data address space (DATA) 

• Bit address space (BIT) 

• External data address space (XDATA) 

• Code address space (CODE) 

• Indirectly addressable data space (IDATA) 
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In some cases the same numeric value is a valid address for all five address spaces. 
To help avoid logic errors in your program, ASM51 attaches a segment type and per- 
forms type checking for instruction operands (and arguments to assembler direc- 
tives), that address these segments. For example, in jump instructions the assembler 
checks that the operand, the target address, has a segment type CODE. Possible seg- 
ment types are DATA, BIT, CODE, XDATA, and IDATA. Chapter 4 describes 
how to define symbols with different segment types. 



Special Assembler Symbols 



The assembler reserves several symbols to designate specific registers as operands. A 
special assembler symbol is encoded in the opcode byte, as opposed to a data address 
which is encoded in an operand byte. Table 2-1 lists these symbols and describes the 
hardware register each represents. 

If the definition of an instruction requires one of these symbols, only that special 
symbol can be used. However, you can, with the SET and EQU directives, define 
other symbols to stand for the accumulator (A) or the working registers (R0,...R7). 
Symbols so defined may not be forward referenced in an instruction operand. You 
cannot use a special assembler symbol for any other purpose in an instruction 
operand or directive argument. Several examples of instructions that use these sym- 
bols are shown below. 



INC DPTR increment the entire 16-bit contents of the Data Pointer by 1 

SETBC ;set the Carry flag to 1 

JMP@A + DPTR ;add the contents of the accumulator to the contents of the data 
;pointer and jump to that address 

In addition to these symbols, the assembler also recognizes the location counter sym- 
bol ($), described in Chapter 4, and the register address symbols ARO, AR1, ..., 
AR7, described with the USING directive in Chapter 4. 





Table 2-1. Special Assembler Symbols 


Special Symbol 


Meaning 


A 


Accumulator 


R0,R1,R2,R3, 
R4, R5, R6, R7 


Stands for the 8 general registers in the currently active bank (4 
register banks available) 


DPTR 


Data pointer: a 16-bit register used for addressing in the code 
address space and the external address space 


PC 


Program counter: a 16-bit register that contains the address of the 
next instruction to be executed 


C 


Carry flag receives ALU carry out and borrow from bit 7 of the 
operands 


AB 


Accumulator/ B register pair used in MUL and DIV instructions 
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Indirect Addressing 



An indirect address operand identifies a register that contains the address of a 
memory location to be used in the operation. The actual location affected will 
depend on the contents of the register when the instruction is executed. In most 
instructions indirect addresses affect on-chip RAM. However, the MOVC and 
MOVX instructions use an indirect address operand to address code memory and 
external data memory, respectively. 

In on-chip indirect addressing (the IDATA space), either register or register 1 of 
the active register bank can be specified as an indirect address operand. The com- 
mercial at sign (@) followed by the register's special symbol (RO or Rl), or a symbol 
defined to stand for the register's special symbol, indicates indirect addressing. On 
the 8051 the address contained in the specified indirect address registers must be 
between and 127 (since you cannot access hardware registers through indirect 
addressing.) If an indirect address register contains a value greater than 127 when it 
is used for on-chip addressing, the program continues with no indication of the 
error. If it is a source operand, a byte containing undefined data is returned. If it is a 
destination operand^ the data is lost. 

The following examples show several uses of indirect addressing. 

ADD A, @ R1 ;add the contents of the on-chip RAM location addressed by 

;register 1 to the accumulator 

INC @ RO -.increment the contents of the on-chip RAM location addressed 

;by register 

MOVX@DPTR,A * ;move the contents of the accumulator to the off-chip memory 
;location addressed by the data pointer 



Immediate Data 



An immediate data operand is a numeric expression that, when assembled, is 
encoded as part of the machine instruction. The pound sign (#) immediately before 
the expression indicates that it is an immediate data operand. The numeric expres- 
sion must be a valid assembly-time expression or RL-time expression. 

The assembler represents all numeric expressions in 16 bits, and converts to the 
appropriate form for instruction encoding. 

Most instructions require the value of the immediate data to fit into a byte. The low 
order byte of the assembler's 16-bit internal representation is used. The assembler 
permits a numeric expression range of values from -256 to +255. These values all 
have a homogeneous high order byte (i.e., all ones or all zeroes) when represented in 
16 bits. The low order byte of the assembler's 16-bit internal representation is used. 
Note that since only the lower order byte is taken as the result of the expression, the 
sign information, i.e., the higher order byte, is lost. 

The immediate data operands that accept a 16-bit value can use any value represent- 
able by the assembler. Immediate data operands do not require any specific segment 
type. XDATA and IDATA type operands can be specified only as immediate 
operands; i.e., you have to load these addresses first into a register and then access 
them. 
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The following examples show several ways of specifying the immediate data 
operand. 



MOV A,#OE0H 
MOVDPTR,#0A14FH 



;place the hex constant EG in the accumulator 

;this is the only instruction that uses a 16-bit immediate data 
;operand 



ANLA,#128 



;mask out all but the high order bit of the accumulator 
;(128-base 10) = 10000000 (base 2) 



MOV R0,#IDATA_SYM 



;Load R0 with IDATA symbol for later access 



Data Addressing 

The data address operand is a numeric expression that evaluates to one of the first 
128 on-chip byte addresses or one of the hardware register addresses. The low-order 
byte of the assembler's 16-bit internal representation is used. This permits a range 
from -256 to 4255. Note that since only the lower order byte is taken as the result of 
the expression, the sign information (i.e., the higher order byte) is lost. Instructions 
that use the data address operand require that the symbol or expression specified be 
either of segment type DATA or be a typeless number. (Symbols are discussed below 
under expression evaluation.) 

The direct data addresses from to 127 access the 805 Ts on-chip RAM space, while 
the addresses from 128 to 255 access the hardware registers. Not all of the addresses 
in the hardware register space are defined. The illustration below (figure 2-1) shows 
Ihe meaningful addresses and their predefined data address names. 

If you read from a reserved address, undefined data will be returned. If you write to 
a reserved address, the data will be lost. Using these pecularities in your program 
may result in incompatibility with future versions of the chip. Note that using 
indirect addressing for locations above 127 will access IDATA space rather than 
hardware register space. 
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Figure 2-1 . Hardware Register Address Area for 8051 
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The following examples show several ways of specifying data addresses. 

MOV P1 ,A ;move the contents of the accumulator to the predefined data address 90 

;(base16)port1 

ORL A, 20*5 ;logical OR of accumulator with location 100 (base 10) uses an 

;assembly-time operator multiply 

INC COUNT ;increment the location identified by the symbol COUNT 

INC 32 ^increment location 32(base 10) in memory 



Bit Addressing 

A bit address represents a bit-addressable location either in the internal RAM (bytes 
32 through 47) or a hardware bit. There are two ways to represent a bit address in an 
operand. 

1. You can specify the byte that contains the bit with a DATA type address, and 
single out the particular bit in that byte with the bit selector ("." period) 
followed by a bit identifier (0-7). For example, FLAGS. 3, 40.5, 21H.0 and 
ACC.7 are valid uses of the bit selector. You can use an assembly-time expres- 
sion to express the byte address or the bit identifier. The assembler will translate 
this to the correct absolute or relocatable value. Note that only certain bytes in 
the on-chip address space are bit addressable. If the data address is specified by 
a relocatable expression, the referenced segment must have 
BIT ADDRESS ABLE relocation type (see Chapter 6 for segments). The expres- 
sion that specifies the bit address must be absolute. 

2. You specify the bit address explicitly. The expression now represents the bit 
address in the bit space (it must have a BIT segment type). Note that bit 
addresses through 127 map onto bytes 32 through 47 of the on-chip RAM, and 
bits 128 through 255 map onto the bit addressable locations of the hardware 
register space (not all the locations are defined). 

If the bit address is used in the context of BIT directive, then the first expression 
must be an absolute or simple relocatable expression. If used in a machine instruc- 
tion where a bit address is expected, then a general relocatable expression is also 
allowed. 

Figures 2-2a and 2-2b show the bits assigned to each numeric bit address. 

The following examples show several ways of specifying bits. 

SETB TR1 ;set the predefined bit address TR1 (timer 1 run flag) 

SETB ALARM ;set the user defined bit ALARM 

SETB88H.6 ;Set bit 6 of location 88H (timer 1 run flag) 

CPL FLAGS.ON .'complement the bit ON of the byte FLAGS 

SETB 8EH ;set the bit address 8E(base 16) (timer 1 run flag) 

As with data addresses, there are several bit addresses that are predefined as symbols 
that you can use in an operand. Table 2-2 shows these predefined bit addresses. You 
can also define your own bit address symbols with the BIT directive described in 
Chapter 4, Assembler Directives. 
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Figure 2-2a. Bit Addressable Bytes in RAM 
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Figure 2-2b. Bit Addressable Bytes in Hardware 
Register Address Area for 8051 
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Table 2-2. Predefined Bit Addresses for 805 1 



Symbol 


Bit 
Position 


Bit 
Address 


Meaning 


CY 


PSW.7 


D7H 


Carry Flag 


AC 


PSW.6 


D6H 


Auxiliary Carry Flag 


FO 


PSW.5 


D5H 


Flag 


RS1 


PSW.4 


D4H 


Register Bank Select Bit 1 


RSO 


PSW.3 


D3H 


Register Bank Select Bit 


OV 


PSW.2 


D2H 


Overflow Flag 


P 


PSW.O 


DOH 


Parity Flag 


TF1 


TC0N.7 


8FH 


Timer 1 Overflow Flag 


TR1 


TC0N.6 


8EH 


Timer 1 Run Control Bit 


TFO 


TC0N.5 


8DH 


Timer Overflow Flag 


TRO 


TC0N.4 


8CH 


Timer Run Control Bit 


IE1 


TC0N.3 


8BH 


Interrupt 1 Edge Flag 


IT1 


TC0N.2 


8AH 


Interrupt 1 Type Control Bit 


IEO 


TC0N.1 


89H 


Interrupt Edge Flag 


ITO 


TCON.O 


88H 


Interrupt Type Control Bit 


SMO 


SC0N.7 


9FH 


Serial Mode Control Bit 


SM1 


SCON. 6 


9EH 


Serial Mode Control Bit 1 


SM2 


SCON. 5 


9DH 


Serial Mode Control Bit 2 


REN 


SC0N.4 


9CH 


Receiver Enable 


TB8 


SCON. 3 


9BH 


Transmit Bit 8 


RB8 


SCON. 2 


9AH 


Receive Bit 8 


Tl 


SC0N.1 


99H 


Transmit Interrupt Flag 


Rl 


SCON.O 


98H 


Receive Interrupt Flag 


EA 


IE.7 


AFH 


Enable All Interrupts 


ES 


IE.4 


ACH 


Enable Serial Port Interrupt 


ET1 


IE.3 


ABH 


Enable Timer 1 Interrupt 


EX1 


IE.2 


AAH 


Enable External Interrupt 1 


ETO 


IE.1 


A9H 


Enable Timer Interrupt 


EXO 


IE.0 


A8H 


Enable External Interrupt 


RD 


P3.7 


B7H 


Read Data for External Memory 


WR 


P3.6 


B6H 


Write Data for External Memory 


T1 


P3.5 


B5H 


Timer/Counter 1 External Flag 


TO 


P3.4 


B4H 


Timer/Counter External Flag 


INT1 


P3.3 


B3H 


Interrupt 1 1nput Pin 


INTO 


P3.2 


B2H 


Interrupt Input Pin 


TXD 


P3.1 


B1H 


Serial Port Transmit Pin 


RXD 


P3.0 


BOH 


Serial Port Receive Pin 


PS 


IP.4 


BCH 


Priority of Serial Port Interrupt 


PT1 


IP.3 


BBH 


Priority of Timer 1 1nterrupt 


PX1 


IP.2 


BAH 


Priority of External Interrupt 1 


PTO 


IP.1 


B9H 


Priority of Timer 


PXO 


IP.O 


B8H 


Priority of External Interrupt 



Code Addressing 

Code addresses are either absolute expressions whose values are within to 65,535, 
or relocatable expressions with a segmet type of CODE. There are three types of 
instructions that require a code address in their operands. They are relative jumps, 
in-block (2K page) jumps or calls, and long jumps or calls. 



2-7 



Operands and Expressions MCS-5 1 

The difference between each type is the range of values that the code address 
operand may assume. All three expect an expression which evaluates to a CODE 
type address (an absolute expression between and 65,535 or a relocatable 
operand), but if you specify a relative jump or an in-block jump, only a small subset 
of all possible code addresses is valid/Instructions that use the code address operand 
require that the symbol or expression specified be either of segment type CODE or a 
typeless number. (Symbols and labels are discussed below under absolute expression 
evaluation.) 

Relative Jumps (S JMP and Conditional Jumps) 

The code address in a relative jump must be close to the relative jump instruction 
itself. The range is from -128 to +127 bytes from the first byte of the instruction that 
follows the relative jump. 

The assembler takes the specified code address and computes a relative offset that is 
encoded as an 8-bit 2's complement number. That offset is added to the contents of 
the program counter (PC) when the jump is made; but since the PC is always incre- 
mented to the next instruction before the jump is executed, the range is computed 
from the succeeding instruction. 

When you use a relative jump in your code, you must use an expression that 
evaluates to the code address of the jump destination. The assembler does all the 
offset computations. If the address is out of range, the assembler will issue an error 
message. 

In-Block Jumps and Calls (AJMP and ACALL) 

The code address operand to an in-block jump or call is an expression that is 
evaluated and then encoded in the instruction. The low order 11 bits of the destina- 
tion address are placed in the opcode byte and the operand byte. When the jump or 
call is executed, the 1 1-bit page address replaces the low order 11 bits of the program 
counter. This permits a range of 2048 bytes, or anywhere within the current block. 
The current block is thus determined by the high order 5 bits of the address of the 
next instruction. If the operand is not in the current block, this is an assembler (or 
RL51) error. 

Note that if the in-block jump or call is the last instruction in a block, the high order 
bits of the program counter change when incremented to address the next instruc- 
tion; thus the jump will be made within that new block. 

Long Jumps and Calls (LJMP and LCALL) 

The code address operand to a long jump or call is an expression that will be 
evaluated and then encoded as a 16-bit value in the instruction by the assembler, or, 
if the expression is relocatable, by RL51. All 16 bits of the program counter are 
replaced by this new value when the jump or call is executed. Since 16 bits are used, 
any value representable by the assembler will be acceptable (0 - 65,535). 

The following examples show each type of instruction that calls for a code address. 

SJMP LABEL ;Jump to LABEL (relative offset LABEL must be within -128 and +127 

;of instruction that follows S JMP 

ACALL SORT ;Call subroutine labelled SORT (SORT must be an address within the 

;current2Kpage) 

LJMP EXIT ;Long jump; the label or symbol EXIT must be defined somewhere in 

;the program. 
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Generic Jump and Call (JMP and CALL) 

The assembler provides two instruction mnemonics that do not represent a specific 
opcode. They are JMP and CALL. JMP may assemble to ACALL or LCALL. 
These generic mnemonics will always evaluate to an instruction, not necessarily the 
shortest, that will reach the specified code address operand. 

This is an effective tool to use during program development, since sections of code 
change drastically in size with each development cycle. (See Chapter 3 for a complete 
description of both generic jumps.) Note that the assembler decision may not be 
optimal. For example, if the code address is a forward reference, the assembler will 
generate a long jump although an in-block or short jump may be possible. 



Assembly-Time Expression Evaluation 

An expression is a combination of numbers, character strings, symbols, and 
operators that evaluate to a single 16-digit binary number. Except for some direc- 
tives, all expressions can use forward references (symbols that have not been defined 
at that point in the program) and any of the assembly-time operators. 



Specifying Numbers 

You can specify numbers in hexadecimal (base 16), decimal (base 10), octal (base 8), 
and binary (base 2). The default representation, used when no base designation is 
given, is decimal. Table 2-3 below shows the digits of each numbering system and 
the base designation character for each system (upper- and lowercase characters are 
permitted). 

The only limitation to the range of numbers is that they must be representable within 
16 binary digits. 

Table 2-4 gives several examples of number representation in each of the number 
systems. 

Table 2-3. Assembly Language Number Representation 



Number System 



Base Designator 



Digits in Order of Value 



Binary 
Octal 
Decimal 
Hexadecimal 



B 

OorQ 

Dor (nothing) 

H 



0, 1 

0, 1, 2, 3, 4, 5, 6, 7 

0, 1, 2, 3, 4, 5, 6, 7, 8, 9 

0, 1, 2, 3, 4, 5, 6, 7, 

8, 9, A, B, C, D, E, F 



Table 2-4. Examples of Number Representation 


base 16 


base 10 


base 8 


base 2 


50H 


80 


120Q 


01010000B 


0ACH* 


172D 


254Q 


10101100B 


01 h 


1 


1Q 


1B 


10H 


16d 


20Q 


10000B 



*A hexadecimal number must start with a decimal digit; is used here. 
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Internally, ASM51 represents all numeric values with 16 bits. When ASM51 
encounters a number in an expression, it immediately converts it to 16-bit binary 
representation. Numbers cannot be greater than 65,535. Appendix H describes con- 
version of positive numbers to binary representation. 

Negative numbers (specified by the unary operator "-") are represented in 2's 
complement notation. There are two steps to converting a positive binary number to 
a negative (2's complement) number. 



0000 0000 0010 0000B = 20H 

1111 1111 1101 1111 =Not20H 

1111 1111 1110 0000 = (Not20H)+1 

1111 1111 1110 0000B = -20H 



1. Complement each bit in the number. 

2. Add 1 to the complement. 



To convert back simply perform the same two steps again. 

Although 2's complement notation is used, ASM51 does not convert these numbers 
for comparisons. Therefore, large positive numbers have the same representation as 
small negative numbers (e.g., -1 = 65,535). Table 2-5 shows number interpretation 
at assembly-time and at program execution-time. 



Table 2-5. Interpretations of Number Representation 



Number Characteristic 


Assembly-Time 
Expression Evaluation 


Program Execution 
Arithmetic 


Base Representation 

Range 

Evaluates To: 

Internal Notation 

Signed/Unsigned 
Arithmetic 


Binary, Octal, Decimal, 
or Hexadecimal 

0-65,535 

16 Bits 

Two's Complement 

Unsigned 


Binary, Octal, Decimal, 
or Hexadecimal 

User Controlled 

User Interpretation 

Two's Complement 

User Interpretation 



Character Strings in Expressions 



The MCS-51 assembler allows you to use ASCII characters in expressions/Each 
character stands for a byte containing that characters ASCII code. (Appendix H 
contains a table of the ASCII character codes.) That byte can then be treated as a 
numeric value in an expression. In general, two characters or less are permitted in a 
string (only the DB directive accepts character strings longer than two characters). In 
a one character string the high byte is filled with O's. With a two character string, the 
first character's ASCII value is placed in the high order byte, and the second 
character's value is placed in the low order byte. 

All character strings must be surrounded by the single quote character ('). To 
incorporate the single quote character into the string, place two single quote 
characters side-by-side in a string. For example, 'z'" is a string of two characters: a 
lower case "Z" and the single quote character. 
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The ability to use character strings in an expression offers many possibilities to 
enhance the readability of your code. Below, there are two examples of how 
character strings can be used in expressions. 

TEST: CJNE A,rX\SKIP ; If A contains X then fall through 
JMP FOUND ; Otherwise, jump to skip and 

SKIP: MOV A,@R1 ; Move next character into accumulator 

INCR1 ; Change R1 to point to next character 

DJNZ R2JEST ; JUMP to TEST if there are still more 

; characters to test 

MOV A.SBUF ; Move character in serial port buffer 

; to accumulator 
SU BB A,#'0' ; Subtract '0' from character just read 

; this returns binary value of the digit 

NOTE 

A corollary of this notation for character strings is the null string— two 
single quotes surrounding no characters (side-by-side). When the null 
character string is used in an expression it evaluates to 0, but when used as 
an item in the expression list of a DB directive it will evaluate to nothing and 
will not initiate memory. (See Chapter 4 for an example.) 

Use of Symbols 

The assembler has several kinds of symbols available to the programmer. They may 
stand for registers, segments, numbers,and memory addresses. They allow a pro- 
grammer to enhance Ihe readability of his code. 

Symbols are defined by four attributes: 

• Type-— register, segment, number, address 

• Segment Type— DATA, BIT, XDATA, CODE, IDATA 

• Scope— local, public, external 

• Value — register name, segment base address, constant value, symbol address 
(depending on type) 

Not all of these four attributes are valid combinations. 

The type attribute provides a common classification to the symbols: 

• Register — indicates symbols which were defined as such by EQU or SET 
directives 

• Segment— indicates symbols which were designated as relocatable segments 

• Number— indicates that the symbol represents a pure number and can be used in 
any expression. (It has no segment type.) 

• Address— indicates that the symbol represents a memory address. 

The segment type specifies, for segment symbols, the address space where the seg- 
ment resides. For address type symbols, it specifies the way the symbol may be used 
(as a DATA address, BIT address, etc.). Usually it is identical to the address space in 
which the owning segment was defined. The only exception is for symbols defined as 
bits within a BITADDRESSABLE DATA type segment (see the Bit directive in 
Chapter 4). Such symbols have a BIT type. 

The scope attribute is valid for number and address type symbols. It specifies 
whether the symbol is local, public, or external. 
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The value attribute is defined with respect to the type of the symbol: 

• Register— the value is the name (in ASCII) of the register 

• Segment— the value is the base address (computed at RL-time) 

• Number — the value of the constant 

• Address— for an absolute symbol, the value is the absolute address within the 
containing address space. For a relocatable address symbol, the value is the off- 
set (in bits or bytes depending on the segment type) from the base of its owning 
segment. 

Once you have defined a symbol anywhere in your program (some expressions 
require that no forward references be used), you can use it in any numeric operand 
in the same way that you would use a constant, providing you respect segment type 
conventions. The segment type required for each numeric operand is described 
above. The creation of user-defined symbols is completely described in Chapter 4. 

Besides the user-defined symbols, there are several predefined addresses available 
for the hardware registers and flags. Table 2-6 shows all of the predefined data 
address symbols and the values they represent. The bit address symbols have been 
listed earlier in this chapter. (See Table 2-2.) 

Remember that these symbols evaluate to a data address and cannot be used in 
instructions that call for a special assembler symbol. 



ADDA,#5 
ADDACC,#5 



; This is a valid instruction. A is the special 
; assembler symbol required for this operand 
; This is an invalid instruction and will generate 
; an error message. ACC is an address and not 
; the special symbol required for the instruction 



There is an additional symbol that may be used in any numeric operand, the location 
counter ($). When you are using the location counter in an instruction's operand, it 



Table 2-6. 


Predefined Data Addresses for 805 1 


Symbol 


Hexadecimal 
Address 


Meaning 


ACC 


EO 


Accumulator 


B 


FO 


Multiplication Register 


DPH 


83 


Data Pointer (high byte) 


DPL 


82 


Data Pointer (low byte) 


IE 


A8 


Interrupt Enable 


IP 


B8 


Interrupt Priority 


PO 


80 


PortO 


P1 


90 


Port 1 


P2 


AO 


Port 2 


P3 


BO 


Port 3 


PSW 


DO 


Program Status Word 


SBUF 


99 


Serial Port Buffer 


SCON 


98 


Serial Port Controller 


SP 


81 


Stack Pointer 


TCON 


88 


Timer Control 


THO 


8C 


Timer (high byte) 


TH1 


8D 


Timer 1 (high byte) 


TLO 


8A 


Timer (low byte) 


TL1 


8B 


Timer 1 (low byte) 


TMOD 


89 


Timer Mode 
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will stand for the address of the first byte of the instruction currently being encoded. 
You can find a complete description of how to use and manipulate the location 
counter in Chapter 4, Assembler Directives. 

Using Operators in Expressions 

There are four classes of assembly-time operators: arithmetic, logical, special, and 
relational. All of them return a 16-bit value. Instruction operands that require only 8 
bits will receive the low order byte of the expression. The distinction between each 
class of operators is loosely defined. Since they may be used in the same expression, 
they work on the same type of data, and they return the same type of data. 

Arithmetic Operators 

Table 2-7 contains a list of all the arithmetic operators. 

Table 2-7. Arithmetic Assembly-Time Operators 



Operator 


Meaning 


+ 

/ 
MOD 


Unary plus or add 

Unary minus or subtract 

Multiplication 

Integer division (discard remainder) 

Modular division (discard quotient) 



The following examples all produce the same bit pattern in the low order byte 
(00110101B): 

+53 

27+26 

-203 

65-12 

2*25+3 multiplication is always executed before the addition 

160/3 

153 MOD 100 

Note that the MOD operator must be separated from its operands by at least one 
space or tab, or have the operands enclosed in parentheses. 

Logical Operators 

Table 2-8 contains a list of all logical operators. The logical operators perform their 
operation on each bit of their operands. 



Table 2-8. 


Logical Assembly-Time Operators 


Operator 


Meaning 


OR 




Full 16-bit OR 


AND 




Full 16-bit AN.D 


XOR 




Full 16-bit exclusive OR 


NOT 




Full 16-bit complement 



The following examples all produce the same 8-bit pattern in the low order byte 
(00110101B): 

0001 0001 B OR 00110100B 

01110101B AND 10110111B 

11000011B XOR 11110110B 

NOT 11001010B 
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Note that all logical operators must be separated from their operand by at least one 
space or tab, or have the operands enclosed in parentheses. 



Special Assembler Operators 

Table 2-9 contains a list of all special operators: 



Table 2-9. Special Assembly-Time Operators 


Operator 


Meaning 


SHR 


16-bit shift right 


SHL 


16-bit shift left 


HIGH 


Select the high order byte of operand 


LOW 


Select the low order byte of operand 


( ) 


Evaluate the contents of the parenthesis first 



The following examples all produce the same 8-bit pattern in the low order byte 
(00110101B): 



01AFHSHR3 



HIGH(1135HSHL8) 



LOW1135H 



Bits are shifted out the right end 
and is shifted into the left. 

Parenthesis is required since HIGH 
has a greater precedence than SHL. 
Bits are shifted out the left and 
is shifted in the right. 

Without using the LOW operator, 
the high order byte would have 
caused an error in an 8-bit 
operand. 

Note SHR, SHL, HIGH and LOW must be separated from their operands by at 
least one space or tab, or have the operands enclosed in parentheses. 

Relational Operators 

The relational operators differ from all of the other operators in that the result of a 
relational operation will always be either (False) or OFFFFH(True). Table 2-10 
contains a list of all the relational operators: 



Table 2-10. 


Relational Assembly-Time Operators 


Operator 


Meaning 


EQ = 




Equal 


NE <> 




Not equal 


LT < 




Less than 


LE <= 




Less than or equal to 


GT > 




Greater than 


GE >= 




Greater than or equal to 
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The following examples all will return TRUE (OFFFFH): 

27H EQ 39D 

27H <> 27D 

33 LT 34 

7>5 

16 GE 10H 

Note that the two-letter (mnemonic) form of the relational operator must be 
separated from their operands by at least one space or tab; the symbolic form does 
not. If the space or tab is not used, the operand must be enclosed in parentheses. 



Operator Precedence 

Every operator is given a precedence in order to define which operator is evaluated 
first in an expression. For example, the expression 3*5+1 could be interpreted as 16 
or 18 depending on whether the + or the * is evaluated first. The following list shows 
the precedence of the operators in descending order. 

Parenthesized expression ( ) 

HIGH, LOW 

*, /, MOD, SHL, SHR 

+, - unary and binary forms 

EQ, NE, LT, LE, GT, GE, =, <>, <, <=, >, >= 

NOT 

AND 

OR, XOR 



All operators on the same precedence level are evaluated from left to right in the 
expression. 



Segment Typing in Expressions 

Most expressions formed with assembly-time operators do not have a segment type, 
but some operations allow the expression to assume the segment type of a symbol 
used in the expression. The rules for expressions having a segment type are listed 
below. 

1. 



2. 



3. 



The result of a unary operation (+, -, NOT, LOW, HIGH) will have the same 
segment type as that of its operand. 

The result of all binary operations except plus (+) and minus (-) will have no 
segment type (i.e., NUMBER). 

For a binary plus or minus operation, if only one of the operands has a segment 
type, then the result will have that segment type. If not, the result will have no 
segment type. 



This means that only memory address plus or minus a number (or a number plus or 
minus a number) gives a memory address. All other combinations produce a typeless 
value. For example, code-address + (data address 1 - data__address 2) pro- 
duces a value which is a CODE address; (data address 1 - data address 2) has 

no segment type. 
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Relocatable Expression Evaluation 

A relocatable expression is an expression that contains a relocatable or external 
reference, called the "relocatable symbol." Such an expression cannot be com- 
pletely evaluated at assembly time. The Relocator and Linker program (RL51) 
finalizes such expressions using its additional knowledge; i.e., where the relocatable 
segments and the public symbols are located. 

A relocatable expression may usually contain only one relocatable symbol. 
However, when subtracting ("-") or comparing (">", EQ, etc.) relocatable symbols 
which refer to the same relocatable segment, the result is absolute quantity, and 
these symbols are not counted as relocatable. 

The relocatable symbol may be modified by adding or subtracting an absolute quan- 
tity (called offset). Thus the following forms result in valid relocatable expressions: 

relocatable_symbol + absolute_expression 
relocatable_symbol - absolute_expression 
absolute_expression + relocatable_symbol 

There are two types of relocatable expressions: simple relocatable expressions which 
can be used for symbol definition and code generation; and general relocatable 
expressions which can be used only in code generation. 

Simple Relocatable Expressions 

In simple relocatable expressions the relocatable symbol can only represent an 
address in a relocatable segment. External and segment symbols are not allowed. 

Simple relocatable expressions can be used in three contexts: 

1 . As an operand to the ORG statement. 

2. As an operand to the following symbol definition directives: EQU, SET, 
CODE, XDATA, IDATA, BIT or the DATA directives. 

3. As an operand to a machine instruction or a data initialization directive (DB or 
DW). 

Examples: 

VALID 

REL1 + ABS1*10 

REL2-ABS1 

REL1 + (REL2 - REL3) ... assuming REL2 and REL3 refer to the same segment 

INVALID 

(REL1 + ABS1)*10 ...relocatable quantity may not be multiplied 

EXT1 - ABS1 ...this is a general relocatable expression 

REL1 + REL2-REL3. ..you cannot add relocatable symbols (REL1,REL2) 

General Relocatable Expressions 

General relocatable expressions can be used only in statements which generate code; 
i.e., as operands to machine instructions, or as items in a DB or DW directive. 

In this case the relocatable symbol may be a simple relocatable symbol (representing 
an address in a relocatable segment), a segment symbol (representing the base 
address of a relocatable segment), or an external symbol. 
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In addition, the relocatable expression may be prefixed by the LOW or the HIGH 
operator. 

Examples 

VALID 

REL1 + ABSriO 
EXT1 - ABS1 
LOW(SEG1 + ABS1) 

INVALID 

(REL1 + ABS1)*10,.. relocatable quantity may not be multiplied 
EXT1 - REL1 ...you can add/subtract only absolute quantities 
LOWSEG1 + ABS1 ...LOW/ HIGH may be applied only to the final relocatable expression 

(or to an absolute expression); the expression here is equivalent to 

(LOWSEG1) + ABS1 



2-17 




CHAPTER 3 
INSTRUCTION SET 



This chapter contains complete documentation for all of the 8051 instructions. The 
instructions are listed in alphabetical order by mnemonic and operands. 

Introduction 

This chapter is designed to be used as a reference. Each instruction is documented 
using the same basic format. The action performed by an instruction is defined in 
three ways. First, the operation is given in a short notation; the symbols used and 
their meanings are listed in the table below. The operation is then defined in a few 
sentences in the description section. Finally, an example is given showing all of the 
registers affected and their contents before and after the instruction. 

NOTE 

The only exception is that the program counter (PC) is not always shown. 
All instructions increment the PC by the number of bytes in the instruction. 
The "Example:" entry for most instructions do not show this increment by 
the PC. Only those instructions that directly affect the PC (e.g., JMP, 
AC ALL, or RET) show the contents of the PC before and after execution. 

The list of notes that appears at the bottom of some instructions refer to side-effects 
(flags set and cleared and limitations of operands). The numbers refer to the notes 
tabulated on page 3-143/3-144. You can unfold that page for easier reference while 
,y ou are studying the instruction set. 

The "Operands:" entry for each instruction briefly indicates the range of values and 
segment type permitted in each operand. For a complete description of the limits of 
any operand see Chapter 2. In general, the operand's name will identify what section 
to consult. 

With one exception, the operands to 3 byte instructions are encoded in the same 
order as they appear in the source. Only the "Move Memory to Memory" instruc- 
tion is encoded with the second operand preceding the first. 
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The illustration below (figure 3-1) describes the meaning of each section of the 
instruction documentation. 



ADD 

Add Immediate Data 

Mnemonic: ADD 

Operands: A Accumulator 

data -256 <= data <= + 255 

Format: ADD AJdata 

Bit Pattern: , . . 

| 00100100 {Immediate Data] 

7 7 

Operation: (A) - (A) + data 

Bytes: 2 
Cycles: l 

Flags: c ac fo rsi rso ov p 

i»i«i i i i*n»i 

PSW 

Description: This instruction adds the 8-bit immediate data value to the contents 
of the accumulator. It places the result in the accumulator. 

Example: ADD AJ32H ; Add 32H to accumulator 

Encoded Instruction: 

j 00100100 I ooi iooTcT] 

7 7 

Before After 

Accumulator Accumulator 

1 001 001 1 6~] | Q1011000~| 

7 7 

Notes: 4, 5, 6, 7 

Figure 3-1 . Format For Instruction Definitions 

Mnemonic: shows opcode mnemonic. It is shown in upper case, but upper or 
lower case characters are permitted. 

Operands: indicates range and type of operands permitted. 

Format: shows the format of the instruction, including the order of operands 
on the source line. 

Bit Pattern: indicates bit pattern in opcode and position of operands when 
encoded. Letters in the opcode's bit pattern vary with operand specified. 

Operation: symbolically defines the operation performed by the instruction. 
The symbols used in this entry are defined in table 3-1 . 

Bytes and Cycles: shows the number of bytes of code and the number of 
machine cycles used by the instruction. 

Flags: indicates any status flag that may be changed during the execution of 
the instruction. 

Description: is a brief prose description of the operation performed by the 
instruction. 

Example: shows an example instruction as it would appear in the source. It 
also shows the bit pattern of the encoded instruction, and the contents of all 
registers affected by the instruction, immediately before and after the instruc- 
tion is executed. 

The PC is incremented by all instructions, but only instructions that affect the 
PC as part of their operation show its contents in the example. 

Notes: indicates the notes on page 3-142 that pertain to the instruction. 
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Instruction Set 



Table 3-1. 


Abbreviations and Notations Used 


A 


Accumulator 


AB 


Register Pair 


B 


Multiplication Register 


bit address 


8051 bit address 


page address 


1 1 -bit code address within 2K page 


relative offset 


8-bit 2's complement offset 


C 


Carry Flag 


code address 


Absolute code address 


data 


Immediate data 


data address 


On-chip 8-bit RAM address 


DPTR 


Data pointer 


PC 


Program Counter 


Rr 


Register(r=0-7) 


SP 


Stack pointer 


high 


High order byte 


low 


Low order byte 


H 


Bits i through j 


.n 


Bitn 


AND 


Logical AND 


NOT 


Logical complement 


OR 


Logical OR 


XOR 


Logical exclusive OR 


+ 


Plus 


- 


Minus 


/ 


Divide 


* 


Multiply 


(X) 


The contents of X 


((X)) 


The memory location addressed by (X) 




(The contents of X) 


= 


Is equal to 


<> 


Is not equal to 


< 


Is less than 


> 


Is greater than 


*- 


Is replaced by 
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Absolute Call Within 2K Byte Page 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



ACALL 
code address 
ACALL code address 



aaa10001 aaaaaaaa 



7 



(PC) «- (PC) + 2 
(SP) - (SP) + 1 
((SP)) ^ (PC low) 
(SP)-(SP) + 1 
{(SP))^ (PC high) 
(PC) 0-1 *- page address 



c 


AC 


F0 


RS1 RSO 


OV 




P 



















PSW 

This instruction stores the incremented contents of the program 
counter (the return address) on the stack. The low-order byte of the 
program counter (PC) is always placed on the stack first. It replaces 
the low-order 11 bits of the PC with the encoded 11 -bit page 
address. The destination address specified in the source must be 
within the 2K byte page of the instruction following the ACALL. 

The 3 high-order bits of the 11 -bit page address form the 3 high- 
order bits of the opcode. The remaining 8 bits of the address form 
the second byte of the instruction. 
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ACALL 



Example: 



ORG 35H 

ACALL SORT ; Call SORT (evaluates to page 
; address 233H) 





SORT: 


ORG 233H 

PUSH ACC ; Store Accumulator 






ret" 


; Return from call 


Encoded Instruction: 






01010001 


00110011 




7 


7 







Before 






After 


Program Counter 




Program Counter 


00000000 


| 00110101 


00000010 00110011 


15 8 


7 





15 8 7 


Stack Pointer 






Stack Pointer 


00100110 


00101000 


7 


7 


(27H) 


I 




(27H) 


00000000 


00110111 


7 


7 


(28H) 


I 




(28H) 


00000000 


00000000 


7 


7 


Notes: 2,3 
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ADD 



MCS-51 



Add Immediate Data 



Mnemonic: 


ADD 


Operands: 


A Accumulator 

data -256 <= data <= + 255 


Format: 


ADD Mdata 


Bit Pattern: 






00100100 Immediate Data 




7 7 


Operation: 


(A) +- (A) + data 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




• # • • 



PSW 

Description: This instruction adds the 8-bit immediate data value to the contents 
of the accumulator. It places the result in the accumulator. 



Example: ADD 


A,#32H 


; Add 32 


Encoded Instruction: 






00100100 00110010 


7 7 







Before 




After 


Accumulator 




Accumulator 


00100110 


01011000 


7 


7 


Notes: 4,5,6,7 







3-6 



MCS-51 



ADD 



Add Indirect Address 



Mnemonic: 


ADD 


Operands: 


A Accumulator 

Rr Register 0<=r<=1 


Format: 


ADD A,@Rr 


Bit Pattern: 






0010011r 




7 


Operation: 


(A)-(A) + ((Rr» 


Bytes: 1 
Cycles: 1 





Flags: 



C AC FO RS1 RSO OV 



• # • • 



PSW 



Description: This instruction adds the contents of the data memory location 
addressed by register r to the contents of the accumulator. It places 
the result in the accumulator. 



Example: ADDA,@R1 

Encoded Instruction: 



Add indirect address to accumulator 



00100111 




7 




Before 


After 


Accumulator 


Accumulator 


10000110 


11101000 


7 


7 


Register 1 


Register 1 


00011100 


00011100 


7 


7 


(1CH) 


(1CH) 


01100010 


01100010 


7 


7 


Notes: 5,6,7, 15 
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MCS-51 



Add Register 


Mnemonic: 


ADD 


Operands: 


A Accumulator 

Rr Register 0<=r<=7 


Format: 


ADD A,Rr 


Bit Pattern: 






00101rrr 




7 


Operation: 


(A)-(A) + (Rr) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC FO RS1 RSO OV P 




•i. .i . 



PSW 

Description: This instruction adds the contents of register r to the contents of 
the accumulator. It places the result in the accumulator. 



Example: ADD 


A,R6 


; Add Re 


Encoded Instruction: 






00101110 




7 




Before 




After 


Accumulator 




Accumulator 


01110110 


11111011 


7 


7 ^ 


Register 6 




Register 6 


10000101 


10000101 


7 


7 


Notes: 5,6,7 
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ADD 



Add Memory 



Mnemonic: ADD 



Operands: 

Format: 
Bit Pattern: 



A Accumulator 

data address <= data address <= 255 

ADD A, data address 



00100101 



Data Address 



7 7 

Operation: (A) «- (A) + (data address) 

Bytes: 2 
Cycles: 1 



Flags: 



C AC F0 RS1 RS0 OV 



• • + # 



PSW 



Description: This instruction adds the contents of the specified data address to 
the contents of the accumulator. It places the result in the 
accumulator. 



Example: 


ADD 


A,32H 


; Add the contents of 
;32H to accumulator 


Encoded Instruction: 






00100101 


0110 010 




7 7 







Before 




After 


Accumulator 






Accumulator 




00100110 




01111001 




7 




7 




(32H) 






(32H) 




01010011 




01010011 




7 




7 




Notes: 5,6,7, i 


i 
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Add Carry Plus Immediate Data to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



ADDC 

A 
data 



Accumulator 

-256 <= data <= +255 



ADDC Mdata 





011010 Immediate Data 




7 7 


Operation: 


(A) - (A) + (G) + data 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




• • • # 



PSW 

Description: This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator. The 8-bit immediate data value is 
added to that intermediate result, and the carry flag is updated. The 
accumulator and carry flag reflect the sum of all three values. 



Example: ADDC A,#0AFH 

Encoded Instruction: 



; Add Carry and 0AFH to accumulator 



00110100 


10101111 


7 


7 







Before 






After 


Accumulator 






Accumulator 


01110001 


00100001 


7 


7 


Carry 






Carry 


m 






m 


Notes: 4,5,6,' 


I 
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ADDC 



Add Carry Plus Indirect Address to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 

Flags: 
Description: 



ADDC 

A Accumulator 

Register 0<=r<=1 

ADDC A,@Rr 



001 1 01 1 r 



7 

(A)-(A) + (C) + ((Rr)) 

C AC F0 RS1 RSO OV 



• • # • 



PSW 



This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator. The contents of data memory at the 
location addressed by register r is added to that intermediate result, 
and the carry flag is updated. The accumulator and carry flag 
reflect the sum of all three values. 
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Example: ADDC A,@R1 



; Add carry and indirect address to 
; accumulator 



Encoded Instruction: 



00110111 




7 
Before 
Accumulator 


After 
Accumulator 


11101000 


00000000 


7 
Register 1 


7 
Register 1 


01101001 


01101001 


7 
(69H) 


7 
(69H) 


00011000 


00011000 


7 
Carry 

hi 

Notes: 5,6,7, 


7 
Carry 

hi 

15 
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AD DC 



Add Carry Plus Register to Accumulator 



Mnemonic: 


ADDC 


Operands: 


A Accumulator 
Register 0<=r<=7 


Format: 


ADDC A,Rr 


Bit Pattern: 






00111rrr 




7 


Operation: 


(A)-(A) + (C) + (Rr) 


Bytes: 1 
Cycles: 1 





Flags: 



C AC FO RS1 RSO OV 



• | ♦ | | | • | • 



PSW 



Description: This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator at bit 0. The contents of register r is 
added to that intermediate result, and the carry flag is updated. The 
accumulator and carry flag reflect the sum of all three values. 



Example: 



ADDC A,R7 



; Add carry and register 7 
; to accumulator 



Encoded Instruction: 



00111111 


7 


Before 


Accumulator 


00110000 


7 


Register 7 


00001010 


7 


Carry 


m 


Notes: 5,6,7 



After 
Accumulator 



| 00111011 


7 
Register 7 


00001010 


7 
Carry 
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Add Carry Plus Memory to Accumulator 



ADDC 

A Accumulator 

data address <= data address <= 255 

ADDC k^data address 



0110101 



Data Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction adds the contents of the carry flag (0 or 1) to the 
contents of the accumulator. The contents of the specified data 
address is added to that intermediate result, and the carry flag is 
updated. The accumulator and carry flag reflect the sum of all 
three values. 



7 7 

(A) <- (A) + (C) + {data address) 

C AC F0 RS1 RS0 OV P 



mm • • 



Example: ADDC 


A,25H 


; Add carry and contents of 25H to 
; accumulator 


Encoded Instruction: 






00110101 00100101 


7 7 







Before 




After 


Accumulator 




Accumulator 


10101110 


10110101 


7 


7 


(25H) 




(25H) 


00000111 


00000111 


7 


7 


Carry 




Carry 


m 




m 


Notes: 5,6,7,8 
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Absolute Jump within 2K Byte Page 



AJMP 

code address 

AJMP code address 



aaaOOOOl aaaaaaaa 



7 7 

(PC) - (PC) + 2 

(PC) 0-1 — page address 



c 


AC 


F0 


RS1 RSO 


OV 




P 



















AJMP 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction replaces the low-order 11 bits of the program 
counter with the encoded 11 -bit address. The destination address 
specified in the source must be within the 2K byte page of the 
instruction following the AJMP. 

The 3 high-order bits of the 11 -bit page address form the 3 high- 
order bits of the opcode. The remaining 8 bits of the address form 
the second byte of the instruction. 

Example: ORG0E80FH 

TOPP: MOVA,R1 



ORG OEADCH 

AJMP TOPP ; Jump backwards to TOPP 
; at location 0E80FH 



Encoded Instruction: 



00000001 


00001111 



7 7 

Before 
Program Counter 



After 

Program Counter 



11101010 | 11011100 



15 8 

Notes: None 



11101000 00001111 



15 



8 
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Logical AND Immediate Data to Accumulator 



Mnemonic: 


ANL 


Operands: 


A Accumulator 

data -256 <= data <= + 255 


Format: 


ANL A,#data 


Bit Pattern: 






[ 0101010 Immediate Data 




7 7 


Operation: 


(A) *- (A) AND data 


Bytes: 2 
Cycles: 1 





Flags: 



c 


AC 


F0 RS1 RS0 OV 




P 


I 




i 








# 



PSW 



Description: This instruction ANDs the 8-bit immediate data value to the 
contents of the accumulator. Bit n of the result is 1 if bit n of each 
operand is 1; otherwise bit n is 0. It places the result in the 
accumulator. 

Example: ANL A,#00O01000B ; Mask out all but bit 3 

Encoded Instruction: 



| 01010100 


00001000 




7 


7 







Before 






After 


Accumulator 






Accumulator 


| 01110111 


00000000 


7 


7 


Notes: 4,5 
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ANL 



Logical AND Indirect Address to Accumulator 



Mnemonic: 


ANL 


Operands: 


A Accumulator 

Rr Register 0<=r<=1 


Format: 


ANL A,@Rr 


Bit Pattern: 






01 01 01 1 r 




7 


Operation: 


(A) -(A) AND ((Rr)) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




• 



PSW 

Description: This instruction ANDs the contents of the memory location 
addressed by the contents of register r to the contents of the 
accumulator. Bit n of the result is 1 if bit n of each operand is 1; 
otherwise bit n is 0. It places the result in the accumulator. 



Example: ANL A,@R0 

Encoded Instruction: 



; AND indirect address with 
; accumulator 



01010110 




7 




Before 


After 


Accumulator 


Accumulator 


00111111 


00001111 


7 


7 


Register 


RegisterO 


01010010 


01010010 


7 


7 


(52H) 


(52H) 


00001111 


00001111 


7 


7 


Notes: 5, 15 
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Logical AND Register to Accumulator 



Mnemonic: 


ANL 


Operands: 


A Accumulator 
Rr <= Rr <= 7 


Format: 


ANL A,Rr 


Bit Pattern: 






01 01 1 rrr 




7 


Operation: 


(A)^(A)AND(Rr) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




* 



PSW 

Description: This instruction ANDs the contents of register r to the contents of 
the accumulator. Bit n of the result is 1 if bit n of each operand is 1 ; 
otherwise bit n is 0. It places the result in the accumulator. 



; AND register 4 with accumulator 



Example: MOV R4,#10000000B ; Mov 
ANL A,R4 ;AND 


Encoded Instruction: 






01011100 




7 




Before 




After 


Accumulator 




Accumulator 



10011001 



7 

Register 4 



10000000 



10000000 


7 
Register 4 


10000000 



7 

Note: 5 
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ANL 



Logical AND Memory to Accumulator 



Mnemonic: ANL 



Operands: 

Format: 
Bit Pattern: 



A Accumulator 

data address <= data address <= 255 

ANL k.data address 



01010101 



Data Address 



7 7 

Operation: (A) «- (A) AND (data address) 

Bytes: 2 
Cycles: 1 



Flags: 



C AC F0 RS1 RS0 OV 



• 



PSW 



Description: This instruction ANDs the contents of the specified data address to 
the contents of the accumulator. Bit n of the result is 1 if bit n of 
each operand is also 1 ; otherwise bit n is 0. It places the result in the 
accumulator. 



Example: ANL 


A,37H 


; AND contents of 37H with 
; accumulator 


Encoded Instruction: 






01010101 00110111 


7 7 







Before 




After 


Accumulator 




Accumulator 


01110111 


01110000 


7 


7 


(37H) 




(37H) 


11110000 


11110000 


7 


7 


Notes: 5,8 
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Logical AND Bit to Carry Flag 



Mnemonic: 


ANL 


Operands: 


C Carry Flag 

bit address <= bit address <= 255 


Format: 


ANL C,bit address 


Bit Pattern: 






10000010 Bit Address 




7 7 


Operation: 


(C) - (C) AND (bit address) 


Bytes: 2 
Cycles: 1 





Flags: 



Description: 



C AC F0 RS1 RS0 OV 



£ 



PSW 

This instruction ANDs the contents of the specified bit address to 
the contents of the carry flag. If both bits are 1, then the result is 1; 
otherwise, the result is 0. It places the result in the carry flag. 



Example: ANL C,37.3 

Encoded Instruction: 



10000010 | 0010101T 



7 
Before 



Carry Flag 

cn 

(37) 

| 0010111T 



7 3 
Notes: None 



; AND bit 3 of byte 37 with Carry 



After 



Carry Flag 

hi. 

(37) 


00101110 
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ANL 



Logical AND Complement of Bit to Carry Flag 



Mnemonic: 


ANL 


Operands: 


C Carry Flag 

bit address <= bit address <= 255 


Format: 


ANL CJ bit address 


Bit Pattern: 






10110000 Bit Address 




7 7 


Operation: 


(C) - (C) AND NOT (bit address) 


Bytes: 2 
Cycles: 2 





Flags: 



C AC F0 RS1 RS0 OV 



• 



PSW 



Description: This instruction ANDs the complemented contents of the specified 
bit address to the contents of the carry flag. The result is 1 when the 
carry flag is 1 and the contents of the specified bit address is 0. It 
places the result in the carry flag. The contents of the specified bit 
address does not change. 



Example: ANL 


C/40.5 


; Complement contents of 40.5 
; then AND with Carry 


Encoded Instruction: 






| 10110000 01000101 


7 7 







Before 




After 


Carry Flag 




Carry Flag 


m 




m 


(40) 




(40) 


| 01011000 


01011000 


7 5 


7 5 


Notes: None 
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Logical AND Immediate Data to Memory 



Mnemonic: 


ANL 


Operands: 


data address <=data address <= 255 
data -256<=a(ate<=+255 


Format: 


ANL data address ,#data 


Bit Pattern: 






01010011 Data Address Immediate Data 



7 7 7 

(data address) *- (data address) AND data 



Operation: 

Bytes: 3 
Cycles: 2 

Flags: 



PSW 

Description: This instruction ANDs the 8-bit immediate data value to the 
contents of the specified data address. Bit/? of the result is 1 if bit n 
of each operand is also 1 ; otherwise, bit n is 0. It places the result in 
data memory at the specified address. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















Example: 



MOV 57H,PSW 
ANL 57H,#01H 



; Move PSW to 57H 

; Mask out all but parity bit 

; to check accumulator parity 



Encoded Instruction: 



01010011 


01010111 


00000001 



7 
Before 
(57H) 



7 
After 
(57H) 



01110111 



00000001 



7 

Notes: 4,9 
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ANL 



Logical AND Accumulator to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 

Description: 

Example: 



ANL 

data address <= data address <= 255 
A Accumulator 

ANL data address A 



01010010 



Data Address 



7 7 

(data address) *- {data address) AND A 






PSW 

This instruction ANDs the contents of the accumulator to the 
contents of the specified data address. Bit n of the result is 1 if bit n 
of each operand is also 1 ; otherwise, bit n is 0. It places the result 
in data memory at the specified address. 



MOV A,#1 0000001 B 
ANL 10H,A 



; Load mask into accumulator 
; Mask out all but bits and 7 



Encoded Instruction: 



01010 010 


00010000 



7 

Before 
Accumulator 



After 
Accumulator 



10000001 



10000001 



7 
(10H) 



7 
(10H) 



00110001 



| 00000001 



7 
Note: 9 
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Generic Call 



Mnemonic: 

Operands: 

Format: 

Bit Pattern: 

Operation: 

Flags: 



Description: 



CALL 

code address 

CALL code address 

Translated to ACALL or LCALL as needed 

Either ACALL or LCALL 

C AC FO RS1 RSO OV P 



PSW 

This instruction is translated to ACALL when the specified code 
address contains no forward references and that address falls 
within the current 2K byte page; otherwise; it is translated to 
LCALL. This will not necessarily be the most efficient representa- 
tion when a forward reference is used. See the description for 
ACALL and LCALL for more detail. 



Example: 


SUB3: 


ORG 80DCH 

CALL SUB3 ; Call SUB3 (SUB3 is a forward 

; reference so LCALL is encoded 
; even though ACALL would work in 
; this case.) 

POP55H ;Address8233H 


Encoded Instruction: 






00010010 


10000010 


00110011 


7 


7 





7 


Before 






After 


Program Counter 




Program Counter 


| 10000000 


11011100 


10000010 00110011 


7 


7 





15 8 7 


Stack Pointer 






Stack Pointer 


01 1001 00 


01100110 


7 


7 


(65H) 






(65H) 


| 00000000 


11011111 


7 


7 


(66H) 






(66H) 


| 00000000 


10000000 


7 


7 


Notes: 1,2,3 









3-24 



MCS-51 



CJNE 



Compare Indirect Address to Immediate Data, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



CJNE 

Rr Register 0<=r<=1 

data -256 <= data <= + 255 

code address 

CJNE @Rr,#c/afa, code address 



I 1011011~7 



Immediate Data 



Rel. Offset 



7 



7 



(PC) -(PC) + 3 
\F((Rr))Odata 
THEN 

(PC) «- (PC) + relative offset 
\F((Rr))<data 
THEN * 

(C)-1 
ELSE 

(C)-0 



C AC FO RS1 RSO OV 



• 



PSW 

This instruction compares the immediate data value with the 
memory location addressed by register r. If they are not equal, con- 
trol passes to the specified code address. If they are equal, then 
control passes to the next sequential instruction. 

If the immediate data value is greater than the contents of the 
specified data address, then the carry flag is set to 1 ; otherwise, it is 
reset to 0. 

The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-25 



CJNE 



Example: 



CJNE @R1,#01,SCAB', Jump if contents of 
; indirect address do 
; not equal 1 



MCS-51 



SCAB: MOVCFO 
Encoded Instruction: 



;5AH bytes from the 
;beginningof CJNE 



10110111 



00000001 



01010111 



7 


7 


7 


Before 




After 


Register 1 




Register 1 



01010011 



01010011 



7 
(53H) 



7 
(53H) 



11100001 



11100001 



7 

Carry Flag 



7 

Carry Flag 



Q 



Program Counter 



00000000 



11011100 



15 8 7 

Notes: 4,10,11,12,15 







Program Counter 



00000001 



00110110 



15 



8 



3-26 



MCS-51 



CJNE 



Compare Immediate Data to Accumulator, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



CJNE 

A Accumulator 

data -256 <= data <= 4- 255 

code address 

CJNE A,#data, code address 



1011010 Immediate Data Rel. Offset 



7 



7 



(PC) - (PC) + 3 
IF (A) <> data 
THEN 

(PC) - (PC) + relative offset 
\F(A)<data 
THEN 

(C)-1 
ELSE 

(C)-0 



C AC F0 RS1 RSO OV 



• 



PSW 



This instruction compares the immediate data value with the 
contents of the accumulator. If they are not equal, control passes to 
the specified code address. If they are equal, then control passes to 
the next sequential instruction. 

If the immediate data value is greater than the contents of the 
accumulator, then the carry flag is set to 1; otherwise, it is reset 
toO. 

The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-27 



CJNE 



MCS-51 



Example: ORG 10DCH 

CJNE A,#10H, NEXT ; Jump if accumulator does not equal 
;10H 


NEXT: 


INC A ; Location 1136H 


Encoded Instruction: 






10110100 00010000 


01010111 


7 7 





7 


Before 




After 


Accumulator 




Accumulator 


01010000 


01010000 


7 


7 


Carry Flag 




Carry Flag 


m 




m 


Program Counter 




Program Counter 


00010000 11011100 


00010001 | 00110110 


15 8 7 





15 8 7 


Notes: 4,10,11,12 







3-28 



MCS-51 



CJNE 



Compare Memory to Accumulator, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



CJNE 

A Accumulator 

data address <= data address <= 255 

code address 

C J N E A,data address ,code address 



| 10110101 {Data Address 



Rel. Offset 



7 



7 



(PC) - (PC) + 3 

IF (A) < > (data address) 

THEN 

(PC) «- (PC) + relative offset 
IF (A) < (data address) 
THEN 

(C)-1 
ELSE 

(C)-0 



c 


AC F0 RS1 RSO 


ov 




p 


!• 


i i i 









PSW 



This instruction compares the contents of the specified memory 
location to the contents of the accumulator. If they are not equal, 
control passes to the specified code address. If they are equal, then 
control passes to the next sequential instruction. 

If the contents of the specified memory location is greater than the 
contents of the accumulator, then the carry flag is set to 1 ; other- 
wise, it is reset to 0. 

The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-29 



CJNE 



MCS-51 



Example: 



CJNE A,37H, TEST; Jump if 37H and accumulator 
; are not equal 



TEST: INC A 
Encoded Instruction: 



;4FH bytes from CJNE 



10110101 



00110111 01001100 



7 
Before 
(37H) 



01111110 



7 

Accumulator 



00100110 



7 

Carry Flag 



Program Counter 



7 
After 
(37H) 







01111110 



7 

Accumulator 



00100110 



Carry Flag 

m 

Program Counter 



00000000 11011100 



00000001 



0110110 



15 8 7 
Notes: 8,10,11,12 



15 



8 



3-30 



MCS-51 



CJNE 



Compare Immediate Data to Register, 
Jump if Not Equal 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



CJNE 

Rr Register 0<=r<=7 

data -256 <= data <= + 255 

code address 

C J N E Rr , #da ta , code address 



10111rrr 


Immediate Data 


Rel. Offset 



7 



7 



(PC) -(PC) + 3 

\F(Rr)Odata 

THEN 

(PC) — (PC) + relative offset 
\F(Rr)<data 
THEN 

(C)-1 
ELSE 

(C)-0 



C AC FO RS1 RSO OV 



• 



PSW 

This instruction compares the immediate data value with the 
contents of register r. If they are not equal, control passes to the 
specified code address. If they are equal, then control passes to the 
next sequential instruction. 

If the immediate data value is greater than the contents of the 
specified register, then the carry flag is set to 1; otherwise, it is reset 
toO. 

The Program Counter is incremented to the next instruction. If the 
operands are not equal, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-31 



CJNE 



MCS-51 



Example: 



CJNER5,#32H,SKIP10 ; Jump if register 5 does not 

; equal 32H 



SKIP10: 


MOVR5.P0 ;13 bytes from CJNE 


Encoded Instruction: 






10111101 10000000 


00001010 


7 7 





7 


Before 




After 


Register 5 




Register 5 


00000001 


00000001 


7 


7 


Carry Flag 
I 1 I 




Carry Flag 
I 1 I 


I 1 

Program Counter 




I I 

Program Counter 


0000000 11011100 


00000000 11101001 


15 8 7 





15 8 7 


Notes: 4,10,11,12 







3-32 



MCS-51 



CLR 



Clear Accumulator 



Mnemonic: CLR 

Operands: A 

Format: CLR A 
Bit Pattern: 



Accumulator 



11100100 



Operation: (A) *- 

Bytes: 1 
Cycles: 1 



Flags: 



C AC F0 RS1 RSO OV 



s 



PSW 



Description: This instruction resets the accumulator to 0. 
Example: CLR A ; Set accumulator to 

Encoded Instruction: 



11100100 




7 




Before After 


Accumulator 




Accumulator 


00111111 




00000000 


7 




7 


Note: 5 







3-33 



CLR 



Clear Carry Flag 



MCS-51 



Mnemonic: CLR 

Operands: C 

Format: CLR C 
Bit Pattern: 



Carry Flag 



11000011 



Operation: (C)^0 

Bytes: 1 
Cycles: 1 



Flags: 



C AC F0 RS1 RSO OV 



• 



PSW 



Description: This instruction resets the carry flag to 0. 
Example: CLR C ; Set carry flag to 

Encoded Instruction: 



11000011 




7 




Before 


After 


Carry Flag 


Carry Flag 


m 


m 


Notes: None 





3-34 



MCS-51 



Clear Bit 



CLR 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



CLR 

bit address <= bit address <- 255 

CLR bit address 





11000010 Bit Address 




7 7 


Operation: 


(bit address) «-0 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




I 



PSW 
Description: This instruction resets the specified bit address to 0. 
Example: CLR 40.5 ; Set bit 5 of byte 40 to 

Encoded Instruction: 



11000010 


01000101 




7 


7 







Before 






After 


(40) 






(40) 


00100110 


00000110 


7 5 


7 5 


Notes: None 









3-35 



CPL 



MCS-51 



Complement Accumulator 



Mnemonic: CPL 

Operands: A 

Format: CPL A 
Bit Pattern: 



Accumulator 



11110100 ] 



7 

Operation: (A)*- NOT (A) 

Bytes: 1 
Cycles: 1 

Flags: 



c 


AC 


F0 


RS1 RSO OV 




P 


1 






i 









PSW 

Description: This instruction resets each 1 in the accumulator to 0, and sets each 
in the accumulator to 1 . 



Example: CPL A 

Encoded Instruction: 



; Complement accumulator 



11110011 




7 




Before After 


Accumulator 




Accumulator 


00110101 




11001010 | 


7 




7 


Notes: None 







3-36 



MCS-51 



CPL 



Complement Carry Flag 



Mnemonic: 


CPL 


Operands: 


C Carry flag 


Format: 


CPL C 


Bit Pattern: 






| 10110011 




7 


Operation: 


(C) - NOT (C) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




•i i 



PSW 

Description: This instruction sets the carry flag to 1 if it was 0, and resets the 
carry flag to if it was 1 . 

; Complement Carry flag 



Example: 


CPL C 


;c 


Encoded Instr 


uction: 




10110011 




7 




Before 




After 


Carry Flag 




Carry Flag 

L°J 


Notes: None 







3-37 



CPL 



MCS-51 



Complement Bit 



CPL 

bit address <= bit address <= 255 

CPL bit address 



10110010 Bit Address 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction sets the contents of the specified bit address to 1 if 
it was 0, and resets the contents of the bit address to if it was 1 . 



7 7 

(bit address) +- NOT (bit address) 



c 


AC 


F0 


RS1 


RS0 


OV 




P 



















Example: CPL 33.7 




; Set bit 


Encoded Instruction: 






10110010 00001111 


7 7 







Before 




After 


(33) 




(33) 


10100110 


00100110 


7 


7 


Notes: None 







3-38 



MCS-51 



DA 



Decimal Adjust Accumulator 



Mnemonic: DA 



Operands: 
Format: 
Bit Pattern: 



A 
DA A 



Accumulator 



11010100 



Operation: (See description below.) 

Bytes: 1 
Cycles: 1 



Flags: 



Description: 



C AC F0 RS1 RSO OV 



• • 



PSW 

This instruction adjusts the contents of the accumulator to 
correspond to packed binary coded decimal (BCD) representation, 
after an add of two BCD numbers. If the auxiliary carry flag is 1, 
or the contents of the low order nibble (bits 0—3) of the 
accumulator is greater than 9, then 6 is added to the accumulator. 
If the carry flag is set before or after the add or the contents of the 
high order nibble (bits 4—7) is greater than 9, then 60H is added to 
the accumulator. The accumulator and the carry flag contain the 
final adjusted value. 



Example: ADD A,R1 
DA A 


; Adjust 


Encoded Instruction: 




11010100 




7 




Before 


After 


Accumulator 


Accumulator 


10011011 


00000001 


7 


7 


Carry Flag 


Carry Flag 


m 


CD 


Auxiliary Carry Flag 


Auxiliary Carry I 


m 


m 


Notes: 5,6 





; Adjust the Accumulator after add 



3-39 



DEC 



MCS-51 



Decrement Indirect Address 



Mnemonic: DEC 
Operands: Rr 
Format: 
Bit Pattern: 



Register 0<=r<=1 



DEC@Rr 



0001011r 



7 

((Rr))-((Rr))-1 

C AC FO RS1 RSO OV 



Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



PSW 

Description: This instruction decrements the contents of the memory location 
addressed by register r by 1. It places the result in the addressed 
location. 






Example: DEC@R0 

Encoded Instruction: 



; Decrement counter 



| 00010110" 



7 
Before 
Register 



After 
Register 



00110111 



00110111"] 



(37H) 

| 11011101 



7 
(37H) 



11011100 



7 
Note: 15 



3-40 



MCS-51 



DEC 



Decrement Accumulator 



Mnemonic: DEC 

Operands: A 

Format: DEC A 
Bit Pattern: 



Accumulator 



00010100 



7 

(A)«-(A)-1 

C AC F0 RS1 RS0 OV 



Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



PSW 

Description: This instruction decrements the contents of the accumulator by 1. 
It places the result in the accumulator. 

; Decrement accumulator 



□• 



Example: 


DEC A 


Encoded Instruction: 


| 00010100 




7 




Before 




Accumulator 




11010000 




7 




Note: 5 





After 

Accumulator 
| 1100111? 



3-41 



DEC 



MCS-51 



Decrement Register 



DEC 
Rr 
DEC Rr 



Register 0<=r<= 7 



| 00011rr~ 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



PSW 

Description: This instruction decrements the contents of register r by 1 . It places 
the result in the specified register. 



7 

(Rr) «- (Rr) -1 



c 


AC 


FO 


RS1 RSO 


OV 




P 



















Example: DEC R7 

Encoded Instruction: 



; Decrement register 7 



00011111 




7 




Before 


After 


Register 7 


Register 7 


10101011 


10101010 


7 


7 


Notes: None 





3-42 



MCS-51 



Decrement Memory 



DEC 



DEC 

data address <= data address <= 255 

DEC data address 



00010101 Data Address 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction decrements the contents of the specified data 
address by 1 . It places the result in the addressed location. 



7 7 

(data address) «- (data address^ -1 



c 


AC 


F0 


RS» 


.oO 


OV 




P 



















Example: DEC 37H 




; Decrer 


Encoded Instruction: 






00010101 00110111 


7 7 







Before 




After 


<37H) 




(37H) 


11011110 


11011101 


7 


7 


Note: 9 







3-43 



DIV 



MCS-51 



Divide Accumulator by B 



Flags: 



Description: 



Mnemonic: 


DIV 


Operands: 


AB Register Pair 


Format: 


DIV AB 


Bit Pattern: 






10000100 j 




7 


Operation: 


(AB)-(A)/(B) 


Bytes: 1 
Cycles: 4 





C 


AC F0 


RS1 RSO OV 


P 


• 


i 


i i*i 


M 



PSW 

This instruction divides the contents of the accumulator by the 
contents of the multiplication register (B). Both operands are 
treated as unsigned integers. The accumulator contains the quo- 
tient; the multiplication register contains the remainder. 

The carry flag is always cleared. Division by sets the overflow 
flag; otherwise, it is cleared. 



Example: 


MOV B,#5 
DIV AB 


Encoded Instruction: 


10000100 


7 




Before 





Accumulator 
} 01110110" 



; Divide accumulator by 5 



After 

Accumulator 
j 0001 01 11~] 



Multiplication Register (B) 
| 00000101" 



7 

Note: 5 



Multiplication Register (B) 

\ ooooooiT~| 

7 



3-44 



MCS-51 



DJNZ 



Decrement Register and Jump iff Not Zero 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



DJNZ 

Rr Register 0<=r<= 7 

code address 

DJNZ Rr, code address 



11011rrr I Rel. Offset""] 



Operation: 



Bytes: 2 
Cycles: 2 



Flags: 



Description: 



(PC) -(PC) + 2 
(Rr)-(Rr)-1 
IF(Rr)<>0 
THEN 

(PC) - (PC) + relative offset 



C AC FO RS1 RSO OV 



I I I I I I I 



PSW 

This instruction decrements the contents of register r by 1, and 
places the result in the specified register. If the result of the decre- 
ment is 0, then control passes to the next sequential instruction; 
otherwise, control passes to the specified code address. 

The Program Counter is incremented to the next instruction. If the 
decrement does not result in 0, then the relative offset is added to 
the incremented program counter, and the instruction at that 
address is executed. 



Example: 



LOOP1: ADD A,R7 



; ADD index to accumulator 



DJNZR7,LOOP1 
INC A 



Encoded Instruction: 



11011111 



1111 0001 1 



7 
Before 
Register 7 



00000010 



7 

Program Counter 



After 
Register 7 



; Decrement register 7 and 
; jump to LOOP1 (15 bytes 
; backward from INC 
; instruction) 



00000001"] 



7 

Program Counter 



00000100 | 110111 00| { 00000100" 



11001111 



15 8 7 
Notes: 10,11,12 



15 







3-45 



DJNZ 



MCS-51 



Decrement Memory and Jump if Not Zero 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



DJNZ 

data address <= data address <= 255 
code address 

DJNZ data address , code address 



11010101 Data Address Rel. Offset 



7 



7 



(PC) «- (PC) + 3 

(data address) *- (data address) -1 

IF (data address) <> 

THEN 

(PC) <- (PC) + relative offset 



c 


AC 


F0 


RS1 RSO OV 




P 



















PSW 

This instruction decrements the contents of the specified data 
address by 1, and places the result in the addressed location. If the 
result of the decrement is 0, then control passes to the next sequen- 
tial instruction; otherwise, control passes to the specified code 
address. 

The Program Counter is incremented to the next instruction. If the 
decrement does not result in 0, then the relative offset is added to 
the incremented program counter, and the instruction at that 
address is executed. 



3-46 



MCS-51 



DJNZ 



Example: 



LOOP 3: MOVR7,57H 



; Store loop index in register 7 



DJNZ57H,LOOP3 ; Decrement 57H and jump 
INC A ; backward to LOOP3 (51 bytes 

; backwards from the INC A 

; instruction) 



Encoded Instruction: 



11010101 



01010111 



11001010 



7 
Before 
(57H) 



7 
After 
(57H) 



01110111 



01110110 



7 

Program Counter 



7 

Program Counter 



00000000 


11011100 



00000000 



10101001 



15 8 7 

Notes: 9,10, 11,12 



15 



8 



3-47 



INC 



MCS-51 



Increment Indirect Address 



Mnemonic: INC 

Operands: Rr 

Format: INC@Rr 
Bit Pattern: 



Register 0<=r<=1 



0000011r 



7 

Operation: ((Rr)) - ((Rr)) + 1 

Bytes: 1 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



nn 



u 



PSW 



Description: This instruction increments the contents of the memory location 
addressed by register r by 1 . It places the result in the addressed 
location. 



; Increment counter 



Example: INC@R0 


;m 


Encoded Instruction: 




00000110 




7 




Before 


After 


Register 


Register 



00110010 



{32H) 



| 001100lF 
7 

(32H) 



11011101 



11011110 



7 
Note: IS 



3-48 



MCS-51 



INC 



Increment Accumulator 



Mnemonic: 


INC 


Operands: 


A Accumulator 


Format: 


INC A 


Bit Pattern: 






00000100 




7 


Operation: 


(A)-(A) + 1 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




i 



PSW 

Description: This instruction increments the contents of the accumulator by 1 . It 
places the result in the accumulator. 



Example: INC A 

Encoded Instruction: 



; Increment accumulator 



00000100 



7 

Before 
Accumulator 



11010000 



7 

Note: 5 



After 
Accumulator 



11010001"] 



3-49 



INC 



MCS-51 



Increment Data Pointer 



INC 

DPTR Data Pointer 

INC DPTR 



10100011 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 2 

Flags: 



PSW 

Description: This instruction increments the 16-bit contents of the data pointer 
by 1 . It places the result in the data pointer. 



7 

(DPTR) - (DPTR) + 1 



c 


AC 


F0 


RS1 RSO 


OV 




P 



















Example: INC DPTR 


; Increment data pointer 


Encoded Instruction: 




10100011 




7 




Before 


After 


Data Pointer 


Data Pointer 


00001001 11111111 


00001010 00000000 


15 8 7 


15 8 7 


Notes: None 





3-50 



MCS-51 



INC 



Increment Register 



Flags: 



Mnemonic: 


INC 


Operands: 


Rr 


Format: 


INC Rr 


Bit Pattern: 






00001 rrr 




7 


Operation: 


(Rr)«-(Rr) + 1 


Bytes: 1 
Cycles: 1 





Register 0<=r<= 7 



c 


AC 


F0 


RS1 RSO 


OV 




P 



















PSW 



Description: This instruction increments the contents of register r by 1 . It places 
the result in the specified register. 



Example: INC R7 


; Increm 


Encoded Instruction: 




00001111 




7 




Before 


After 


Register 7 


Register 7 


10101011 


10101100 


7 


7 


Notes: None 





3-51 



INC 



MCS-51 



Increment Memory 



ING 

data address <= data address <= 255 

INC data address 



000 0101 Data Address 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction increments the contents of the specified data 
address by 1 . It places the result in the addressed location. 



7 7 

(data address) *- (data address) + 1 



c 


AC 


F0 


RS1 RS0 OV 




P 








i 









Example: INC 37H 




; Increment 37H 


Encoded Instruction: 






00000101 00110111 


7 7 







Before 




After 


(37H) 




(37H) 


11011110 


11011111 


7 


7 


Note: 9 







3-52 



MCS-51 



JB 



Jump if Bit Is Set 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



Description: 



JB 

bit address <= bit address <= 255 
code address 

JB bit address , code address 



| 00100000 



Bit Address 



Rel. Offset 



7 7 7 

(PC) -(PC) + 3 
IF (bit address) = 1 
THEN 

(PC) - (PC) + relative offset 



C AC F0 RS1 RS0 OV 



n 



PSW 

This instruction tests the specified bit address. If it is 1, control 
passes to the specified code address. Otherwise, control passes to 
the next sequential instruction . 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-53 



JB 



Example: 



MCS-51 



JB 39.6, EXIT ; Jump if bit 6 of byte 39 is 1 



SJMPTOP 
EXIT: MOVA,39 



; Move 39 to accumulator (EXIT label 
; is 5 bytes from jump statement) 



Encoded Instruction: 



00100000 


00111110 


00000010 



7 
Before 
(39) 



7 
After 
(39) 



01110111 



01110111 



76 

Program Counter 



76 

Program Counter 



00000000 



11011100 



00000000 


11100001 



15 8 7 

Notes: 10,11,12 



15 



8 



3-54 



MCS-51 



JBC 



Jump and Clear if Bit Is Set 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



JBC 

bit address <= bit address <= 255 
code address 

J BC bit address ,code address 



00010000 


Bit Address 


Rel. Offset 



7 



7 



(PC) - (PC) + 3 
IF (bit address) = 1 
THEN 

(bit address) — 

(PC) - (PC) + relative offset 



c 


AC 


F0 


RS1 


RS0 


OV 




P 



















Bytes: 3 
Cycles: 2 

Flags: 



PSW 

Description: This instruction tests the specified bit address. If it is 1, the bit is 
cleared, and control passes to the specified code address. Other- 
wise, control passes to the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-55 



JBC 



MCS-51 



Example: 



ORG ODCH 

JBC 46. 1, OUT3 ; Test bit 1 of byte 46 
; jump and clear if 1 



ORG136H 
OUT3: INCR7 



Encoded Instruction: 



00010000 


01110001 


01010111 



7 
Before 
(46) 



7 
After 



01110111 



(46) 

I 01110101 



7 10 

Program Counter 



7 10 

Program Counter 



00000000 



11011100 



00000001 



00110110 



15 8 7 
Notes: 10,11,12 



15 



8 



3-56 



MCS-51 



Jump if Carry Is Set 



JC 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



JC 

code address 

JC code address 



01000000 


Rel. Offset 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



Description: 



(PC) - (PC) + 2 
IF(C) = 1 
THEN 

(PC) «- (PC) + relative code 



C AC F0 RS1 RS0 OV 



Mill 



PSW 

This instruction tests the contents of the carry flag. If it is 1, then 
control passes to the specified code address. Otherwise, control 
passes to the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



3-57 



JC 



Example: 



FIXUP: CLR C 



MCS-51 



; Clear carry 



JC FIXUP ; If carry is 1 go to FIXUP 

; 49 bytes backwards from the JC 
; instruction 



Encoded Instruction: 



01000000 



110 01101 



7 
Before 
Carry Flag 







After 
Carry Flag 



n 



n 



Program Counter 



Program Counter 



00000101 



11011100 



00000101 



10101011 



15 8 7 

Notes: 10,11,12 







15 



8 



3-58 



MCS-51 



JMP 



Generic Jump 



Mnemonic: 

Operands: 

Format: 

Bit Pattern: 

Operation: 

Bytes: 
Cycles: 

Flags: 



Description: 



Example: 



JMP 

code address <= code address <= 65,535 

JMP code address 

Translated to AJMP, LJMP, or SJMP, as needed 

Either AJMP, SJMP or LJMP 



c 


AC 


FO 


RS1 RSO 


OV 




P 



















PSW 



This instruction will be translated to SJMP if the specified code 
address contains no forward references and that address falls 
within -128 and +127 of the address of the next instruction. It will 
be translated to AJMP if the code address contains no forward 
references and the specified code address falls within the current 2K 
byte page. Otherwise, the JMP instruction is translated to LJMP. 
If forward references are used to specify the jump destination, then 
it will not necessarily be the most efficient representation. See the 
descriptions for SJMP, AJMP, and LJMP for more detail. 



FF: 
SKIP: 



JMP SKIP 

INCA 

INCR5 



; Jump to SKIP 

; Increment A 

; Increment register 5 



Encoded Instruction: 



00000010 


00000100 


10101011 



7 7 

Before 
Program Counter 



7 

After 
Program Counter 



00000100 



10100111 



00000100 



10101011 



15 8 

Notes: None 



15 



8 



3-59 



JMP 



MCS-51 



Jump to Sum of Accumulator and Data Pointer 



Mnemonic: 


JMP 


Operands: 


A Accumulator 
DPTR Data Pointer 


Format: 


JMP@A + DPTR 


Bit Pattern: 






01110011 




7 


Operation: 


(PC) -(A) + (DPTR) 


Bytes: 1 
Cycles: 2 




Flags: 


C AC F0 RS1 RSO OV P 







PSW 

Description: This instruction adds the contents of the accumulator with the 
contents of the data pointer. It transfers control to the code address 
formed by that sum. 



Example: JMP @A + DPTR 


; Jump relative to the acct 


Encoded Instruction: 






01110011 




7 




Before 




After 


Accumulator 




Accumulator 




01110110 


01110110 


7 


7 


Data Pointer 






Data Pointer 


00000010 10101000 


00000010 10101000 


15 8 7 





15 8 7 


Program Counter 






Program Counter 


| 11001101 00001101 


00000011 


00011110 


15 8 7 







15 8 7 


Notes: None 











3-60 



MCS-51 



JNB 



Jump if Bit Is Not Set 



JNB 

bit address 
code address 

JNB bit address , code address 



0110 Bit Address Rel. Offset 







(PC) - (PC) + 3 
IF (bit address) = 
THEN 

(PC) - (PC) + relative offset 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 



Bytes: 3 
Cycles: 2 

Flags: 



PSW 

Description: This instruction tests the specified bit address. If it is 0, control 
passes to specified code address. Otherwise, control passes to the 
next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















3-61 



JNB 



MCS-51 



Example: 



ORGODCH 

JNB41.6.EXIT ; If bit 6 of byte 41 is go to EXIT 



EXIT: 


ADD A,41 


; At location 136H 


Encoded Instruction: 






00110000 01001110 


01010111 


7 7 





7 


Before 




After 


(41) 




(41) 


00110111 


00110111 


76 


76 


Program Counter 






Program Counter 


00000000 11011100 


00000001 00110110 


15 8 7 







15 8 7 


Notes: 10,11,12 









3-62 



MCS-51 



JNC 



Jump if Carry Is Not Set 



JNC 

code address 

JNC code address 



010100 00 Rel. Offset 







(PC) - (PC) + 2 
IF(C) = 
THEN 

(PC) «- (PC) + relative offset 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction tests the contents of the carry flag. If it is 0, control 
passes to the specified code address. Otherwise, control passes to 
the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
test was successful, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















3-63 



JNC 



Example: FIXUP: M0VA.R5 



MCS-51 



JNC FIXUP ; Jump to FIXUP if carry is 
; (51 bytes backwards) 



Encoded Instruction: 



01010000 



11001101 



7 
Before 



7 



Carry Flag 

m 

Program Counter 



After 
Carry Flag 



Program Counter 



00011100 



11011100 



00011100 



10101011 



15 8 7 
Notes: 10,11,12 



15 



8 7 



3-64 



MCS-51 



JNZ 



Jump if Accumulator Is Not Zero 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



JNZ 

code address 

JNZ code address 



01110000 Rel. Offset 



(PC) «- (PC) + 2 

IF(A)<>0 

THEN 

(PC) - (PC) + relative offset 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction tests the accumulator. If it is not equal to 0, 
control passes to the specified code address. Otherwise, control 
passes to the next sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
accumulator is not 0, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















3-65 



JNZ 



Example: 



MCS-51 



JNZ TEST ; Jump if accumulator is not 
; 77 bytes forward 



TEST: MOVR3.A 
Encoded Instruction: 



01110000 



01001101 



7 

Before 
Accumulator 



After 
Accumulator 



01110111 



01110111 



7 8 

Program Counter 



7 

Program Counter 



00000000 



11011100 



00000001 



0101011 



15 8 7 
Notes: 10,11,12 



15 



8 



3-66 



MCS-51 



JZ 



Jump if Accumulator Is Zero 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 



JZ 

code address 

JZ code address 



01100000 Rel. Offset 



(PC) - (PC) + 2 
IF(A) = 
THEN 

(PC) - (PC) 4- relative offset 



Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction tests the accumulator. If it is 0, control passes to 
the specified code address. Otherwise, control passes to the next 
sequential instruction. 

The Program Counter is incremented to the next instruction. If the 
accumulator is 0, then the relative offset is added to the 
incremented program counter, and the instruction at that address is 
executed. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















3-67 



JZ 



MCS-51 



Example: 



JZ EMPTY ; Jump to EMPTY if accumulator is 



EMPTY: INC A 
Encoded Instruction: 



; 25 bytes from JZ instruction 



01100000 



00010111 



7 

Before 
Accumulator 



7 



After 
Accumulator 



01110110 



7 

Program Counter 



00001111 



11011100 



15 8 7 

Notes: 10,11,12 



01110110 



7 

Program Counter 



00001111 



11011110 



15 



8 7 



3-68 



MCS-51 



Long Call 

Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



LCALL 



LCALL 

code address <= code address <= 65,535 

LCALL code address 



00010010 jCode Addr. high 



Code Addr. low 



7 7 

(PC) *- (PC) + 3 
(SP) *- (SP) + 1 
((SP)) - (PC low) 
(SP)^(SP) + 1 
({SP))*- (PC high) 
(PC) — code address 



7 



Bytes: 3 
Cycles: 2 

Flags: 



PSW 

Description: This instruction stores the contents of the program counter (the 
return address) on the stack, then transfers control to the 16-bit 
code address specified as the operand. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















3-69 



LCALL 



MCS-51 



Example: SERVICE: INC A ; Resides at location 233H 



RETI 





ORG 80 DCH 

LCALL SERVICE ; Call SERVICE 


Encoded Instruction: 




00010010 


00000010 


00110011 


7 


7 


7 


Before 




After 


Program Count 


er 


Program Counter 


10000000 


1101110 


00000010 00110011 


15 8 


7 


15 8 7 


Stack Pointer 




Stack Pointer 


00101000 


00101010 


7 


7 


(29H) 




(29H) 


01110111 


11011111 


7 


7 


(2AH) 




(2AH) 


0000 00 


10 


7 


7 


Notes: 1,2,3 







3-70 



MCS-51 



Long Jump 



LJMP 



LJMP 

code address <= code address <= 65,535 

LJMP code address 



010 Code Addr. high Code Addr. low 



7 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 

Flags: 



PSW 

Description: This instruction transfers control to the 16-bit code address 
specified as the operand. 



7 7 

(PC) «- code address 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















Example: 



ORG 800H 

LJMP FAR ; Jump to FAR 



FAR: INC A 
Encoded Instruction: 



; Current code location (8233H) 



00000010 



10000010 



00110011 



7 7 

Before 
Program Counter 



7 

After 
Program Counter 



00001000 



00000000 



15 8 7 

Notes: None 



10000010 



00110011 



15 



8 7 







3-71 



MOV 



MCS-51 



Move Immediate Data to Indirect Address 



Mnemonic: 


MOV 


Operands: 


Rr Register 0<=r<=1 
data -256 <= data <= + 255 


Format: 


MOV @Rr,#data 


Bit Pattern: 






01 1 1 01 1 r Immediate Data 




7 7 


Operation: 


((Rr))^data 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 







PSW 

Description: This instruction moves the 8-bit immediate data value to the 
memory location addressed by the contents of register r . 



Example: MOV@R1,#01H 

Encoded Instruction: 



; Move 1 to indirect address 



01110111 


00000001 



7 
Before 
Register 1 



After 
Register 1 



00010011 



00010011 



7 

(13H) 



7 

(13H) 



01110111 



00000001 



7 
Notes: 4,15 



3-72 



MCS-51 



MOV 



Move Accumulator to Indirect Address 



Mnemonic: 


MOV 


Operands: 


Rr Register 0<=r<=1 
A Accumulator 


Format: 


MOV@Rr,A 


Bit Pattern: 






1111011r 




7 


Operation: 


((Rr))-(A) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC FO RS1 RSO OV P 







PSW 

Description: This instruction moves the contents of the accumulator to the 
memory location addressed by the contents of register r. 



fxample: MOV@R0,A 

Encoded Instruction: 



; Move accumulator to indirect 
; address 



11110110 




7 


Before After 


Register 




Register 


00111000 


011100 


7 


7 


(38H) 




(38H) 


10011001 




01001100 


7 




7 


Accumulator 




Accumulator 


01001100 


01001100 


7 


7 


Note: 15 







3-73 



MOV 



MCS-51 



Move Memory to Indirect Address 



MOV 

Rr Register 0<=r<=1 

data address <= data address <= 255 

MOV @ Rr,data address 



1 01 001 1 r Data Address 







Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction moves the contents of the specified data address to 
the memory location addressed by the contents of register r . 



7 7 

((Rr)) *- (data address) 



c 


AC 


F0 


RS1 


RSO 


OV 




P 



















Example: MOV@R1,77H 

Encoded Instruction: 



; Move the contents of 77H to indirect 
; address 



10100111 



01110111 



7 
Before 
Register 1 



After 
Register 1 



00001000 



00001000 



7 
(08H) 



7 
(08H) 



00110011 



11111110 



7 
(77H) 



7 
(77H) 



11111110 



11111110 



7 
Notes: 8, 15 



3-74 



MCS-51 



MOV 



Move Immediate Data to Accumulator 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern 



A 
data 

MOV Afdata 



Accumulator 

-256 <= data <= +255 





01110100 Immediate Data 




7 7 


Operation: 


(A)^dafa 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




• 



PSW 

Description: This instruction moves the 8-bit immediate data value to the 
accumulator. 



; Initialize the accumulator to 1 



Example: MOVA,#01H 


; Initial'!/ 


Encoded Instruction: 




01110100 00000001 


7 7 




Before 


After 


Accumulator 


Accumulator 


00100110 


00000001 


7 


7 


Notes: 4,5 





3-75 



MOV 



MCS-51 



Move Indirect Address to Accumulator 



Mnemonic: MOV 



Operands: 


A Accumulator 

Rr Register <= r <= 1 


Format: 


MOVA,@Rr 


Bit Pattern: 






111 001 1 r 




7 


Operation: 


(A) - ((Rr)) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




i 



PSW 

Description: This instruction moves the contents of the data memory location 
addressed by register r to the accumulator. 



Example: MOV A, @R1 

Encoded Instruction: 



; Move indirect address to 
; accumulator 



11100111 




7 




Before 


After 


Accumulator 


Accumulator 


| 10000110 


11101000 


7 


7 


Register 1 


Register 1 


00011100 


00011100 


7 


7 


(1CH) 


(1CH) 


| 11101000 


| 11101000 


7 


7 


Notes: 5, 15 





3-76 



MCS-51 



MOV 



Move Register to Accumulator 



Mnemonic: MOV 

Operands: A 

Rr 

Format: MOV A,Rr 

Bit Pattern: 



Accumulator 
Register 0<=r<= 7 



\ 11101 



r r r 



7 

Operation: (A) «- (Rr) 

Bytes: 1 
Cycles: 1 



Flags: 



C AC F0 RS1 RSO OV 



i i i i i i i 



PSW 



Description: This instruction moves the contents of register r to the 
accumulator. 



Example: MOV A,R6 


; Move F 


Encoded Instruction: 




| 11101110 




7 




Before 


After 


Accumulator 


Accumulator 


00101110 


10000101 


7 


7 


Register 6 


Register 6 


10000101 I 


10000101 


7 


7 


Note: 5 





3-77 



MOV 



MCS-51 



Move Memory to Accumulator 



Mnemonic: MOV 



Operands: 

Format: 
Bit Pattern: 



A Accumulator 

data address <= data address <= 255 

MOV A,data address 



| 1110010T 



Data Address 



7 7 

Operation: (A) «- {data address) 

Bytes: 2 
Cycles: 1 



Flags: 



C AC FO RS1 RSO OV 



• 



PSW 



Description: This instruction moves the contents of data memory at the specified 
address to the accumulator. 



Example: MOVA,P1 

Encoded Instruction: 



; Move the contents of Port 1 to 
; accumulator 



11100101 


10010000 


7 


7 







Before 






After 


Accumulator 






Accumulator 


00100110 


01111001 


7 


7 


Port I (90H) 






Portl(90H) 


01111001 


01111001 


7 


7 


Notes: 5,8 









3-78 



MCS-51 



MOV 



Move Bit to Carry Flag 



Mnemonic: MOV 

Operands: C Carry Flag 

bit address <= bit address <= 255 



Format: 


MOV C,bit address 


Bit Pattern: 






10100010 Bit Address 




7 7 


Operation: 


(C) +- (bit address) 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




• 



PSW 

Description: This instruction moves the contents of the specified bit address to 
the carry flag. 



Example: MOVCJXD 


; Move the contents of TXD to Carry 
; flag 


Encoded Instruction: 




10100010 10110110 


7 7 




Before 


After 


Port 3 (BOH) 


Port 3 (BOH) 


00100010 


| 00100010 


76 


76 


Carry Flag 


Carry Flag 


m 


m 


Notes: None 





3-79 



MOV 



MCS-51 



Move Immediate Data to Data Pointer 



Mnemonic: MOV 

Operands: Data Pointer 

data <= data <= 65,535 



Format: 


MOV DPTR,*data 


Bit Pattern: 






10010000 Imm. Data high Imm. Data low 




7 7 7 


Operation: 


(DPTR)-ofate 


Bytes: 3 
Cycles: 2 




Flags: 


C AC F0 RS1 RS0 OV P 




i i 



\* 



PSW 

Description: This instruction moves the 16-bit immediate data value to the data 
pointer. 

Example: MOV DPTR,#0F4FH ; Initialize the data pointer to 0F4FH 

Encoded Instruction: 



10010000 


00001111 


01001111 



7 

Before 
Data Pointer 



7 



7 

After 

Data Pointer 



00000000 


11011100 



00001111 



01001111 



15 8 7 

Notes: None 



15 



8 7 



3-80 



MCS-51 



MOV 



Move Immediate Data to Register 



Mnemonic: MOV 

Operands: Rr 
data 



Register 0<=r<= 7 
-256 <=data<= + 255 



Format 
Bit Pattern 



MOV Rrfdata 





01111rrr Immediate Data 




7 7 


Operation: 


(Rr)«-data 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




i i 



PSW 
Description: This instruction moves the 8-bit immediate data value to register r. 
Example: MOVR5,#01H ; Initialize register 1 

Encoded Instruction: 
011111101 



00000001 



7 
Before 
Register 5 



7 



After 
Register 5 



00010011 



00000001 



7 
Note: 4 



3-81 



MOV 



MCS-51 



Move Accumulator to Register 



Mnemonic: 


MOV 


Operands: 


Rr Register 0<=r<= 7 
A Accumulator 


Format: 


MOV Rr,A 


Bit Pattern: 






11111rrr 




7 


Operation: 


(Rr)-(A) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC FO RS1 RSO OV P 







PSW 
Description: This instruction moves the contents of the accumulator to register r. 
Example: MOVR7,A ; Move accumulator to register 7 

Encoded Instruction: 



11111111 



7 

Before 
Register 7 



After 
Register 7 



11011100 



00111000 



7 

Accumulator 



7 

Accumulator 



00111000 



00111000 



7 

Notes: None 



3-82 



MCS-51 



MOV 



Move Memory to Register 



Mnemonic: 
Operands: 

Format: 
Bit Pattern 



MOV 

Rr Register 0<=r<= 7 

data address <= data address <= 255 

MOV Rr,data address 





1 1 1 r r r Data Address 




7 7 


Operation: 


(Rr) «- (data address) 


Bytes: 2 
Cycles: 2 




Flags: 


C AC F0 RS1 RSO OV P 







PSW 

Description: This instruction moves the contents of the specified data address to 
register r. 



Example: MOVR4,69H 

Encoded Instruction: 



; Move contents of 69H to register 4 



10101100 



01101001 



7 
Before 
Register 4 



7 



After 
Register 4 



00001010 



11011000 



7 
(69H) 



7 
(69H) 



11011000 



11011000 



7 
Note: 8 



3-83 



MOV 



MCS-51 



Move Carry Flag to Bit 



MOV 

bit address <= bit address <= 255 
C Carry Flag 

MOV bit address, C 



10010010 Bit Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction moves the contents of the carry flag to the 
specified bit address. 



7 7 

(bit address) — (C) 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















Example: MOV2FH.7.C 


; Move C 


Encoded Instruction: 




10010010 01111111 


7 7 




Before 


After 


(2FH) 


(2FH) 


00100110 


| 10100110 


7 


7 


Carry Flag 


Carry Flag 


m 


I . i 
1 ' 1 


Notes: None 





3-84 



MCS-51 



Move Immediate Data to Memory 



MOV 



Mnemonic: MOV 

Operands: data address <= data address <= 255 
data -256 <= data <= + 255 



Format: 
Bit Pattern: 



MOV data address, tidata 



| 01110101 



Data Address 



Immediate Data 



7 7 

Operation: (data address) *- data 

Bytes: 3 
Cycles: 2 

Flags: 



7 



c 


AC 


F0 


RS1 RSO OV 




P 


I 

















PSW 

Description: This instruction moves the 8-bit immediate data value to the 
specified data address . 

Example: MOV TMOD,#01H ; Initialize Timer Mode to 1 

Encoded Instruction: 



01110101 


10001001 


00000001 


7 


7 





7 


Before 






After 


TMOD (89H) 






TMOD (89H) 


| 01110111 | 


| 00000001 


7 


7 


Notes: 4,9 









3-85 



MOV 



MCS-51 



Move Indirect Address to Memory 



MOV 

data address <= data address <= 255 
Rr Register <= r <= 1 

MOV data address , @ Rr 



1 1 1 r Data Address 







Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 2 

Flags: 



PSW 

Description: This instruction moves the contents of memory at the location 
addressed by register r to the specified data address. 



7 7 

[data address) «- ((Rr)) 



c 


AC 


F0 


RS1 RSO 


OV 




P 



















Example: MOV11H,@R1 
Encoded Instruction: 



; Move indirect address to 11 H 



10000111 



00010001 



7 
Before 
(11H) 



7 



After 
(11 H) 



10100101 



10010110 



7 

Register 1 



7 

Register 1 



01011000 



01011000 



7 
(58H) 



7 
(58H) 



10010110 



10010110 



7 

Notes: 9, IS 



3-86 



MCS-51 



MOV 



Move Accumulator to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern 



MOV 

data address <= data address <= 255 
A Accumulator 

MOV data ad dress, A 





11110101 Data Address 




7 7 


Operation: 


{data address) +- (A) 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 







PSW 

Description: This instruction moves the contents of the accumulator to the 
specified data address. 



Example: MOV45H,A 
Encoded Instruction: 



; Move accumulator to 45H 



11110101 



01000101 



7 
Before 
(45H) 



7 



After 
(45H) 



10111101 



10011001 



7 

Accumulator 



7 

Accumulator 



10011001 



10011001 



7 

Note: 9 



3-87 



MOV 



MCS-51 



Move Register to Memory 



Mnemonic: MOV 

Operands: data address <=data address <= 255 
Rr Register 0<=r<= 7 



Format: 
Bit Pattern: 



MOV data addresser 



10001rrr 



Data Address 



7 7 

Operation: (data address) *- (Rr) 

Bytes: 2 
Cycles: 2 

Flags: 



C AC F0 


RS1 RSO OV 


P 


i i 











PSW 

Description: This instruction moves the contents of register r to the specified 
data address. 



Example: MOV7EH,R3 

Encoded Instruction: 



; Move R3 to location 7EH 



10001011 



01111110 



7 
Before 
(7EH) 



7 



After 
(7EH) 



11110111 



10010110 



7 

Rfinister 3 






10010110 



10010110 



7 
Note: 9 



3-88 



MCS-51 



MOV 



Move Memory to Memory 



MOV 

data addressl 
data addre$s2 



<= data addressl <= 255 
<= data address2 <= 255 



MOV data addressl , data address2 



10 0101 Data Address2 Data Addressl 







Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 

Flags: 



PSW 

Description: This instruction moves the contents of the source data address 
(data addressl) to the destination data address (data addressl). 



7 7 7 

(data addressl) *- (data address2) 



c 


AC 


F0 


RS1 RS0 OV 




P 



















Example: MOVB.12H 

Encoded Instruction: 



; Move the contents of 12H to B (F0H) 



10000101 | 00010010 | 1111 oooTo 



7 
Before 



(12H) 

| 1110010? 



7 
After 
(12H) 



11100101 



7 
(F0H) 



7 
(F0H) 



01011101 



11100101 



7 
Note: 16 



3-89 



MOVC 



MCS-51 



Move Code Memory Offset from Data Pointer 
to Accumulator 



Mnemonic: MOVC 



Operands: 

Format: 
Bit Pattern: 



A 
DPTR 



Accumulator 
Data Pointer 



MOVC A,@A + DPTR 



10010011 



Operation: (A) - ((A) + (DPTR)) 

Bytes: 1 
Cycles: 2 



Flags: 



C AC F0 RS1 RSO OV 



• 



PSW 



Description: This instruction adds the contents of the data pointer with the 
contents of the accumulator. It uses that sum as an address into 
code memory and places the contents of that address in the 
accumulator. 

The high-order byte of the sum moves to Port 2 and the low-order 
byte of the sum moves to Port 0. 

Example: MOVCA,@A + DPTR ; Look up value in table 

Encoded Instruction: 



10000011 



7 

Before 
Accumulator 



After 
Accumulator 



00011110 



7 

Data Pointer 



7 

Data Pointer 



00000010 11110001 



00000010 11110001 



15 8 7 

(0302H) 



15 8 

(0302H) 







00011110 



00011110 



7 

Notes: 5 



3-90 



MCS-51 



MOVC 



Move Code Memory Offset from Program 
Counter to Accumulator 



Flags: 



Mnemonic: 


MOVC 


Operands: 


A Accumulator 
PC Program Counter 


Format: 


MOVCA,@A + PC 


Bit Pattern: 






10000011 




7 


Operation: 


(PC) - (PC) + 1 
(A)-((A) + (PQ) 


Bytes: 1 
Cycles: 2 





C AC F0 RS1 RS0 OV 



• 



PSW 



Description: This instruction adds the contents of the incremented program 
counter with the contents of the accumulator. It uses that sum as an 
address into code memory and places the contents of that address 
in the accumulator . 

The high-order byte of the sum moves to Port 2 and the low-order 
byte of the sum moves to Port 0. 



3-91 



MOVC 



MCS-51 



Example: MOVCA,@A + PC ; Look up value in table 
Encoded Instruction: 



| 10000011 








7 




Before 






After 


Accumulator 






Accumulator 


| 01110110 


| 01011000 


7 


7 


Program Count 


er 




Program Counter 


00000010 


00110001 


00000010 00110010 


15 8 


7 





15 8 7 


(02A8H) 






(02A8H) 


01011000 


01011000 


7 


7 


Notes: 5, 12 









3-92 



MCS-51 



MOVX 



Move Accumulator to External Memory 
Addressed by Data Pointer 



Mnemonic: 


MOVX 


Operands: 


DPTR Data Pointer 
A Accumulator 


Format: 


MOVX@DPTR,A 


Bit Pattern: 






| 11110000 




7 


Operation: 


((DPTR)) -(A) 


Bytes: 1 
Cycles: 2 




Flags: 


C AC F0 RS1 RSO OV P 







PSW 

Description: This instruction moves the contents of the accumulator to the 
off-chip data memory location addressed by the contents of the 
data pointer. 

The high-order byte of the Data Pointer moves to Port 2, and the 
low-order byte of the Data Pointer moves to Port 0. 



Example: MOVX @DPTR,A 

Encoded Instruction: 



; Move accumulator at data pointer 



| 11110000 | 
7 

Before 

Data Pointer 






After 

Data Pointer 




| 00110000 | 


00110011 


| 00110000 


00110011 


15 8 
(3033H) 


7 





15 8 
(3033H) 


7 


j 11111001 


01001100 




7 
Accumulator 


7 
Accumulator 




| 01001100 


01001100 




7 
Notes: None 


7 





3-93 



MOVX 



MCS-51 



Move Accumulator to External Memory 
Addressed by Register 



Mnemonic: 


MOVX 


Operands: 


Rr Register 0<=r<=1 
A Accumulator 


Format: 


MOVX @Rr,A 


Bit Pattern: 






1111001r 




7 


Operation: 


((Rr))-(A) 


Bytes: 1 
Cycles: 2 





Flags: 



c 


AC 


FO 


RS1 RSO 


OV 




P 



















PSW 



Description: This instruction moves the contents of the accumulator to the off- 
chip data memory location addressed by the contents of register r , 
and special function register P2. P2 holds the high order byte of the 
address and register r holds the low order byte. 



Example: 



MOV P2,#0 
MOVX@R0,A 



; Move accumulator to indirect 
; address 



3-94 



MCS-51 



MOVX 



Example: MOV P2,#0 

MOVX@R0,A 



Encoded Instruction: 



; Move accumulator to indirect 
; address 



11100010 | 




7 




Before 


After 


Register 


Register 


10111000 


10111000 


7 


7 


(00B8H) 


(00B8H) 


10011001 


01001100 


7 


7 


Accumulator 


Accumulator 


01001100 


01001100 


7 


7 


Notes: None 





3-95 



MOVX 



MCS-51 



Move External Memory Addressed by 
Data Pointer to Accumulator 



Mnemonic: 


MOVX 


Operands: 


A Accumulator 
DPTR Data Pointer 


Format: 


MOVXA,@DPTR 


Bit Pattern: 






| 11100000 




7 


Operation: 


(A) -((DPTR)) 


Bytes: 1 
Cycles: 2 




Flags: 


C AC F0 RS1 RS0 OV P 




i i 



PSW 

Description: This instruction moves the contents of the off-chip data memory 
location addressed by the data pointer to the accumulator. 

The high-order byte of the Data Pointer moves to Port 2, and the 
low-order byte of the Data Pointer moves to Port 0. 



Example: MOVXA,@DPTR 

Encoded Instruction: 



; Move memory at DPTR to 
; accumulator 



11100000 








7 




Before 






After 


Accumulator 






Accumulator 




10000110 


11101000 




7 


7 




Data Pointer 






Data Pointer 


01110011 


11011100 


| 01110011 


11011100 


15 8 


7 





15 8 7 


(73DCH) 






(73DCH) 




| 11101000 


11101000 


7 


7 


Notes: 5 













3-96 



MCS-51 



MOVX 



Move External Memory Addressed by 
Register to Accumulator 



Mnemonic: 


MOVX 


Operands: 


A Accumulator 

Rr Register 0<=r<=1 


Format: 


MOVXA,@Rr 


Bit Pattern: 






111 0001 r 




7 


Operation: 


(A)-((Rr)) 


Bytes: 1 




Cycles: 2 




Flags: 


C AC F0 RS1 RSO OV P 



I I I I I I 



PSW 

Description: This instruction moves the contents of the off chip data memory 
location addressed by register r, and special function register P2 to 
the accumulator. P2 holds the high order byte of the address and 
register r holds the low order byte. 



3-97 



MOVX 



MCS-51 



Example: MOVP2,#55H 
MOVXA,@R1 


; Move it 


Encoded Instruction: 




11100011 




7 




Before 


After 


Accumulator 


Accumulator 


01010100 | 


| 00001000 


7 


7 


Register 1 


Register 1 


00011100 


00011100 


7 


7 


(551 CH) 


(551 CH) 


| 00001000 


00001000 


7 


7 


Notes: 5 





; Move memory at Ri to accumulator 



3-98 



MCS-51 



MUL 



Multiply Accumulator by B 



Flags: 



Description: 



Mnemonic: 


MUL 


Operands: 


AB 


Format: 


MULAB 


Bit Pattern: 






10100100 




7 


Operation: 


(AB)*-(A)*(B) 


Bytes: 1 
Cycles: 4 





Multiply/Divide operand 



C AC F0 RS1 RS0 OV 



• # • 



PSW 

This instruction multiplies the contents of the accumulator by the 
contents of the multiplication register (B). Both operands are 
treated as unsigned values. It places the low-order byte of the result 
in the accumulator, and places the high-order byte of the result in 
the multiplication register. 

The carry flag is always cleared. If the high-order byte of the prod- 
uct is not 0, then the overflow flag is set; otherwise, it is cleared. 



3-99 



MUL 



MOV B,#10 
MULAB 



Example: 

Encoded Instruction: 



| 10100100" 



7 

Before 
Accumulator 



| 0001 1 11l" 



7 

Multiplication Register (B) 



00001010 



MCS-51 



; Move 10 to multiplication register 
; Multiply accumulator by 10 



After 
Accumulator 



\ 00110110 



7 

Multiplication Register (B) 



| 00000001 



Overflow Flag 

m 

Notes: 5 



Overflow Flag 

CD 



3-100 



MCS-51 



NOP 



No Operation 




Mnemonic: 


NOP 




Operands: 


None 




Format: 


NOP 




Bit Pattern: 








| 00000000 






7 




Operation: 


No operation 




Bytes: 1 
Cycles: 1 






Flags: 


C AC F0 RS1 RS0 OV 


p 









PSW 

Description: This instruction does absolutely nothing for one cycle. Control 
passes to the next sequential instruction. 



Example: NOP 

Encoded Instruction: 



; Pause one cycle 



00000000 



7 

Notes: None 



3-101 



ORL 



MCS-51 



Logical OR Immediate Data to Accumulator 



Mnemonic: 


ORL 


Operands: 


A Accumulator 

data -256 <=cfafa<= +255 


Format: 


ORL A,#data 


Bit Pattern: 






010 0100 Immediate Data 




7 7 


Operation: 


(A) «- (A) OR data 


Bytes: 2 
Cycles: 1 





Flags: 



c 


AC 


F0 


RS1 RS0 


OV 




P 
















• 



PSW 



Description: This instruction ORs the 8-bit immediate data value to the contents 
of the accumulator. Bit n of the result is 1 if bit n of either operand 
is 1 ; otherwise bit n is 0. It places the result in the accumulator. 

Example: ORL A,#00001000B ; Set bit 3 to 1 

Encoded Instruction: 



01000100 


00001000 




7 


7 







Before 






After 


Accumulator 






Accumulator 


01110111 


01111111 


7 


7 


Notes: 4, S 









3-102 



MCS-51 



ORL 



Logical OR Indirect Address to Accumulator 



Mnemonic: 


ORL 


Operands: 


A Accumulator 

Rr Register 0<=r<=1 


Format: 


ORL A,@Rr 


Bit Pattern: 






01 0001 1 r 




7 


Operation: 


(A)-(A)OR((Rr)) 


Bytes: 1 
Cycles: 1 





Flags: 



C AC F0 RS1 RSO OV 



• 



PSW 



Description: This instruction ORs the contents of the memory location 
addressed by the contents of register r to the contents of the 
accumulator. Bit n of the result is 1 if bit n of either operand is 1; 
otherwise bit /z is 0. It places the result in the accumulator. 



Example: ORL A,@R0 

Encoded Instruction: 



; Set bit tot 



01000110 




7 




Before 


After 


Accumulator 


Accumulator 


00101000 


00101001 


7 


7 


Register 


Register 


01010010 


01010010 


7 


7 


(52H) 


(52H) 


00000001 


00000001 


7 


7 


Notes: 5, IS 





3-103 



ORL 



MCS-51 



Logical OR Register to Accumulator 



Mnemonic: 


ORL 


Operands: 


A Accumulator 

Rr Register 0<=r<= 7 


Format: 


ORL A,Rr 


Bit Pattern: 






| 01 001 rrr 




7 


Operation: 


(A)-(A)OR(Rr) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




• 



PSW 

Description: This instruction ORs the contents of register r to the contents of the 
accumulator. Bit n of the result is 1 if bit n of either operand is 1; 
otherwise bit n is 0. It places the result in the accumulator. 



Example: ORL 


A,R4 


; Set bit: 


Encoded Instruction: 






| 01001100 | 




7 






Before 




After 


Accumulator 




Accumulator 


| 10010001 


10011001 


7 


7 


Register 4 




Register 4 


| 10001000 


10001000 | 


7 


7 


Note: S 







3-104 



MCS-51 



ORL 



Logical OR Memory to Accumulator 



Mnemonic: ORL 



A Accumulator 

data address <= data address <= 255 



ORL tK, data address 

1 01000101 | Data Address 



Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction ORs the contents of the specified data address to 
the contents of the accumulator. Bit n of the result is 1 if bit n of 
either operand is 1; otherwise bit n is 0. It places the result in the 
accumulator. 



7 7 

(A) <- (A) OR (data address) 

C AC F0 RS1 RS0 OV P 



II • 



Example: ORL 


A,37H 


; OR 37I- 


Encoded Instruction: 






01000101 00110111 


7 7 







Before 




After 


Accumulator 




Accumulator 


01110111 


11110111 


7 


7 


(37H) 




(37H) 


10000000 


10000000 


7 


7 


Notes: 5,8 







3-105 



ORL 



MCS-51 



Logical OR Bit to Carry Flag 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 



ORL 

C 

bit address 



Carry Flag 

<= bit address <= 255 



ORL C,bit address 





01110010 Bit Address 




7 7 


Operation: 


(C) -(C) OR {bit address) 


Bytes: 2 
Cycles: 2 




Flags: 


C AC F0 RS1 RS0 OV P 




• 



PSW 

Description: This instruction ORs the contents of the specified bit address with 
the contents of the carry flag. The carry flag becomes 1 when either 
the carry flag or the specified bit address is 1; otherwise, it is 0. It 
places the result in the carry flag. 



Example: ORL C,46.2 

Encoded Instruction: 



; OR bit 2 of byte 46 with Carry 



01110010 


01110010 




7 


7 







Before 






After 


Carry Flag 

LsJ 






Garry Flag 


(46) 






(46) 


00100110 


00100110 


7 2 


7 2 


Notes: None 









3-106 



MCS-51 



ORL 



Logical OR Complement of Bit to Carry Flag 



Mnemonic: 


ORL 


Operands: 


C Carry Flag 

bit address <= bit address <= 255 


Format: 


ORL Q,l bit address 


Bit Pattern: 






10100000 Bit Address 



Operation: 

Bytes: 2 
Cycles: 2 

Flags: 



Description: 



7 7 

(C) - (C) OR NOT bit address 

C AC F0 RS1 RS0 OV P 



• 



PSW 

This instruction ORs the complemented contents of the specified 
bit address to the contents of the carry flag. The carry flag is 1 
when either the carry flag is already 1 or the specified bit address is 
0. It places the result in the carry flag. The contents of the specified 
bit address is unchanged. 



Example: ORLCJ25H.5 

Encoded Instruction: 



; Complement contents of bit 5 in 
; byte 25H then OR with Carry 



10100000 


00101101 




7 


7 







Before 






After 


Carry Flag 






Carry Flag 

LlI 


(25H) 






(25H) 


| 00000110 


00000110 


7 5 


7 5 


Notes: None 









3-107 



ORL 



MCS-51 



Logical OR Immediate Data to Memory 



Mnemonic: 


ORL 


Operands: 


data address <= data address <= 255 
data -256 <= data <= + 255 


Format: 


ORL data address ,#data 


Bit Pattern: 






| 010 011 Data Address Immediate Data 




7 7 7 


Operation: 


(data address) *- (data address) OR data 


Bytes: 3 
Cycles: 2 




Flags: 


C AC F0 RS1 RS0 OV P 




i 



PSW 

Description: This instruction ORs the 8-bit immediate data value to the contents 
of the specified data address. Bit n of the result is 1 if bit n of either 
operand is 1; otherwise bit n is 0. It places the result in memory at 
the specified address. 



Example: ORL57H,#01H 


;Setbit0to1 


Encoded Instruction: 




01000011 01010111 


00000001 


7 7 


7 


Before 


After 


(57H) 


(57H) 


01110110 


01110111 


7 


7 


Notes: 4,9 





3-108 



MCS-51 



ORL 



Logical OR Accumulator to Memory 



Mnemonic: ORL 

Operands: data address <= data address <= 255 
A Accumulator 



Format: 
Bit Pattern: 



ORL data address, A 



| 01000010 



Data Address 



7 7 

Operation: (data address) *- (data address) OR A 

Bytes: 2 
Cycles: 1 



Flags: 



C AC F0 RS1 RS0 OV 






PSW 



Description: This instruction ORs the contents of the accumulator to the 
contents of the specified data address. Bit n of the result is 1 if bit n 
of either operand is 1; otherwise bit n is 0. It places the result in 
memory at the specified address. 



Example: ORL 10H,A 


; OR accumulator with the contents 
;of10H 


Encoded Instruction: 




01000010 00010000 


7 7 




Before 


After 


Accumulator 


Accumulator 


11110000 


| 11110000 


7 


7 


(10H) 


(10H) 


00110001 


11110001 


7 


7 


Note: 9 





3-109 



POP 



MCS-51 



Pop Stack to Memory 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 

Flags: 



POP 

data address <= data address <= 255 

POP data address 



1 11010000 



Data Address 



7 7 

(data address) ^ ((SP)) 
(SP)*-(SP)-1 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















PSW 

Description: This instruction places the byte addressed by the stack pointer 
at the specified data address. It then decrements the stack pointer 
byl. 



Example: POP PSW 

Encoded Instruction: 



; Pop PSW parity is not affected. 



11010000 


11010000 




7 


7 







Before 






After 


Accumulator 






Accumulator 


11010101 


11010101 


7 


7 


row vuuun) 






PSW (0D0H) 


10101011 


11110011 


7 


7 


Stack Pointer 






Stack Pointer 


00010000 


00001111 


7 


7 


(10H) 






(10H) 


11110010 


11110010 


7 


7 


Notes: 2, 8, 17 









3-110 



MCS-51 



Push Memory onto Stack 



PUSH 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 



PUSH 

data address <= data address <= 255 

PUSH data address 



11000000 


Data Address 



7 7 

(SP) - (SP) + 1 
((SP)) — (data address) 



Flags: 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















PSW 



Description: This instruction increments the stack pointer, then stores the 
contents of the specified data address at the location addressed by 
the stack pointer. 



Example: PUSH4DH 

Encoded Instruction: 



; Push one byte to the stack 



11000000 


01001101 




7 


7 







Before 






After 


(4DH) 






(4DH) 


10101010 


10101010 


7 


7 


Stack Pointer 






Stack Pointer 


00010000 


00010001 


7 


7 


(11H) 






(11H) 


00000000 


10101010 


7 


7 


Notes: 2,3,8 









3-111 



RET 



MCS-51 



Return from Subroutine (Non-interrupt) 



Flags: 



Description: 



Mnemonic: 


RET 


Operands: 


None 


Format: 


RET 


Bit Pattern: 






00100010 




7 


Operation: 


(PC/>/flr/»)«-«SP» 
(SP) *- (SP) -1 
(PC/ow)^((SP)) 
(SP) - (SP) -1 


Bytes: 1 
Cycles: 2 





C 


AC 


F0 


RS1 RS0 OV 




P 
















I 



PSW 

This instruction returns from a subroutine. Control passes to the 
location addressed by the top two bytes on the stack. The high- 
order byte of the return address is always the first to come off the 
stack. It is immediately followed by the low-order byte. 



3-112 



MCS-51 



RET 



Example: RET 

Encoded Instruction: 



; Return from subroutine 



| 00100010 








7 




Before 






After 


Program Counter 




Program Counter 


00000010 


01010101 


| 00000000 01110011 


15 8 


7 





15 8 7 


Stack Pointer 






Stack Pointer 


00001010 


00001000 


7 


7 


(0AH) 






(0AH) 


| 00000000 


00000000 


7 


7 


(09H) 






(09H) 


01110011 


01110011 


J o 


7 


Notes: 2, 17 









3-113 



RETI 



MCS-51 



Return from Interrupt Routine 



Mnemonic: 


RETI 


Operands: 


None 


Format: 


RETI 


Bit Pattern: 






00110010 




7 


Operation: 


(PC high) -((SP)) 
(SP) - (SP) -1 
(PC low) ^((SP)) 
(SP) *- (SP) -1 


Bytes: 1 
Cycles: 2 





Flags: 



Description: 



c 


AC 


F0 


RS1 RS0 OV 




P 



















PSW 

This instruction returns from an interrupt service routine, and 
reenables interrupts of equal or lower priority. Control passes to 
the location addressed by the top two bytes on the stack. The high- 
order byte of the return address is always the first to come off the 
stack. It is immediately followed by the low-order byte. 



3-114 



MCS-51 



RETI 



Example: RETI 

Encoded Instruction: 



; Return from interrupt routine 



00110010 








7 




Before 






After 


Program Counter 




Program Counter 


00001010 


10101010 


00000000 11110001 


15 8 


7 





15 8 7 


Stack Pointer 






Stack Pointer 


00001010 


00001000 


7 


7 


(0AH) 






(0AH) 


00000000 


00000000 


7 


7 


(09H) 






(09H) 


11110001 


11110001 


7 


7 


Notes: 2, 17 









3-115 



RL 



MCS-51 



Rotate Accumulator Left 



Mnemonic: 


RL 






Operands: 


A Accumulator 




Format: 


RLA 




Bit Pattern: 








00100011 | 






7 




Operation: 


C 

□ 


ACCUMULATOR 












.«««««««.,, 




7 





Bytes: 1 
Cycles: 1 








Flags: 


C AC F0 RS1 RS0 OV P 






i 





PSW 



Description: This instruction rotates each bit in the accumulator one position to 
the left. The most significant bit (bit 7) moves into the least signifi- 
cant bit position (bit 0). 



Example: RL A 

Encoded Instruction: 



; Rotate accumulator left one positon. 



00100011 




7 




Before After 


Accumulator 




Accumulator 


11010000 




10100001 


7 




7 


Notes: None 







3-116 



MCS-51 



RLC 



Rotate Accumulator and Carry Flag Left 



Mnemonic: 


RLC 




Operands: 


A Accumulator 




Format: 


RLC A 




Bit Pattern: 








| 00110011 






7 




Operation: 


C ACCUMULATOR 






I 1~* I -r- I -r- -r- -r I ^- I - I ^ 


^ 




I r \ 4 \* I ^ I *■ I ^ 


* 




I 7 





Bytes: 1 
Cycles: 1 






Flags: 


C AC F0 RS1 RSO OV P 






!• I 





PSW 

Description: This instruction rotates each bit in the accumulator one position to 
the left. The most significant bit (bit 7) moves into the Carry flag, 
while the previous contents of Carry moves into the least significant 
bit (bit 0). 



Example: RLC A 


; Rotate accumulator and carry left 
;onepositon. 


Encoded Instruction: 




| 00110011 | 




7 




Before 


After 


Accumulator 


Accumulator 


| 00011001 | 


00110011 | 


7 


7 


Carry Flag 


Carry Flag 


Note: S 





3-117 



RR 



MCS-51 



Rotate Accumulator Right 



Mnemonic: 


RR 






Operands: 


A Accumulator 




Format: 


RRA 




Bit Pattern: 








00000011 






7 




Operation: 


C 

□ 


ACCUMULATOR 






^ ** 










7 






Bytes: 1 
Cycles: 1 

Flags: 



PSW 

Description: This instruction rotates each bit in the accumulator one position to 
the right. The least significant bit (bit 0) moves into the most 
significant bit position (bit 7) . 



c 


AC 


F0 


RS1 RS0 OV 




P 



















Example: RRA 



Encoded Instruction: 



; Rotate accumulator right one 
; positon. 



00000011 




7 




Before After 


Accumulator 




Accumulator 


11010001 




11101000 


7 




7 


Notes: None 







3-118 



MCS-51 



Rotate Accumulator and Carry Flag Right 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 1 
Cycles: 1 

Flags: 



RRC 
A 
RRC A 



Accumulator 



00010011 







C AC F0 RS1 RS0 OV 



RRC 



c 




ACCUMULATOR 




















t 


7 








PSW 

Description: This instruction rotates each bit in the accumulator one position to 
the right. The least significant bit (bit 0) moves into the Carry flag, 
while the previous contents of Carry moves into the most signifi- 
cant bit (bit 7). 



Example: RRC A 



Encoded Instruction: 



; Rotate accumulator and carry right 
;onepositon. 



00010011 


7 


Before 


Accumulator 


10011000 


7 


Carry Flag 


m 


Note: 5 



After 
Accumulator 



11001100 


7 


Carry Flag 

L±J 



3-119 



SETB 



MCS-51 



Set Carry Flag 



SETB 

C 

SETBC 



Carry Flag 



11010011 



7 

(C)-1 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 1 
Cycles: 1 

Flags: 



PSW 
Description: This instruction sets the carry flag to 1 . 
Example: SETB C ; Set Carry to 1 

Encoded Instruction: 



c 


AC 


F0 


RS1 RSO 


OV 




P 


• 

















11010011 



7 

Before 
Carry Flag 



After 



Carry Flag 

m 



Notes: None 



3-120 



MCS-51 



Set Bit 



SETB 



SETB 

bit address <= bit address <= 255 

SETB bit address 



11010010 Bit Address 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 

PSW 
Description: This instruction sets the contents of the specified bit address to 1 . 



7 7 

{bit address) *-1 



c 


AC 


F0 


RS1 


RS0 


OV 




P 



















Example: SETB 41.5 

Encoded Instruction: 



; Set the contents of bit 5 in byte 41 
;to1 



11010010 


01001101 




7 


7 







Before 






After 


(41) 






(41) 


| 01000110 


01100110 


7 5 


7 5 


Notes: None 









3-121 



SJMP 



MCS-51 



Short Jump 



Mnemonic: 
Operands: 
Format: 
Bit Pattern: 

Operation: 



Bytes: 2 
Cycles: 2 



Flags: 



SJMP 

code address 

SJMP code address 



10000000 


Re!. Offset 



7 7 

(PC) - (PC) + 2 

(PC) - (PC) + relative offset 



c 


AC 


F0 


RS1 RS0 OV 




P 



















PSW 



Description: This instruction transfers control to the specified code address. The 
Program Counter is incremented to the next instruction, then the 
relative offset is added to the incremented program counter, and 
the instruction at that address is executed. 



Example: 



SJMP BOTTOM ; Jump to BOTTOM 
FF:INCA 



BOTTOM: RRA 



; (15 bytes ahead from the INC 
; instruction) 



Encoded Instruction: 



10000000 



00001111 



7 7 

Before 
Program Counter 



11101000 



11011100 



15 8 7 

Notes: 10,11,12 



After 

Program Counter 



11101000 



11101101 1 



15 



8 



3-122 



MCS-51 



SUBB 



Subtract Immediate Data from 
Accumulator with Borrow 



Mnemonic: 


SUBB 


Operands: 


A Accumulator 

data -256 <= data <= +255 


Format: 


SUBBA,#ofafa 


Bit Pattern: 






10010100 Immediate Data 




7 7 


Operation: 


(A) «- (A) - (C) - data 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




• • • • 



PSW 

Description: This instruction subtracts the contents of the Carry flag and the 
immediate data value from the contents of the accumulator. It 
places the result in the accumulator. 



Example: SUBBA,#0C1H 

Encoded Instruction: 



; Subtract 0C1H from accumulator 



10010100 


01100100 




7 


7 







Before 






After 


Accumulator 






Accumulator 


00100110 


01100100 


7 


7 


Carry Flag 

LlI 






Carry Flag 


Auxiliary Carry Flag 

L±J 




Auxiliary Carry Flag 

LlI 


Overflow Flag 






Overflow Flag 

LlJ 


Notes: 4,5,6, 


13,14 







3-123 



SUBB 



MCS-51 



Subtract Indirect Address from 
Accumulator with Borrow 



Mnemonic: 


SUBB 


Operands: 


A Accumulator 

Rr Register 0<=r<=1 


Format: 


SUBBA,@Rr 


Bit Pattern: 






1 001 01 1 r 




7 


Operation: 


(A)-(A)-(C)-((Rr)) 


Bytes: 1 
Cycles: 1 





Flags: 



C AC F0 RS1 RSO OV 



• • # • 



PSW 



Description: This instruction subtracts the Carry flag and the memory location 
addressed by the contents of register r from the contents of the 
accumulator. It places the result in the accumulator. 



3-124 



MCS-51 



SUBB 



Example: SUBBA,@R1 

Encoded Instruction: 



; Subtract the indirect address from 
; accumulator 



10010111 | 




7 




Before 


After 


Accumulator 


Accumulator 


| 10000110 


00100100 


7 


7 


Register 1 


Register 1 


00011100 | 


00011100 


7 


7 


(1CH) 


(1CH) 


01100010 


01100010 


7 


7 


Carry Flag 

UJ 


Carry Flag 

LaJ 


Auxiliary Carry 


Flag Auxiliary Carry Flag 

LlI 


Overflow Flag 

LsJ 


Overflow Flag 

LlI 



Notes: 5,6,13,14,15 



3-125 



SUBB 



MCS-51 



Subtract Register from Accumulator with Borrow 



Mnemonic: 


SUBB 


Operands: 


A Accumulator 

Rr Register 0<=r<= 7 


Format: 


SUBBA,Rr 


Bit Pattern: 






10011rrr 




7 


Operation: 


(A)-(A)-(C)-(Rr) 


Bytes: 1 
Cycles: 1 





Flags: 



Description: 



C AC FO RS1 RSO OV 



• • • • 



PSW 

This instruction subtracts the contents of the Carry flag and the 
contents of register r from the contents of the accumulator. It 
places the result in the accumulator. 



3-126 



MCS-51 



SUBB 



Example: SUBBA,R6 

Encoded Instruction: 



; Subtract R6 from accumulator 



10011110 






7 




Before 




After 


Accumulator 




Accumulator 


01110110 


11110000 


7 


7 


R6 




R6 


10000101 


10000101 


7 


7 


Carry Flag 

L±J 




Carry Flag 

LlI 


Auxiliary Carry 

hi 

Overflow Flag 



Flag 


Auxiliary Carry Flag 

LlI 

Overflow Flag 

hJ 


Notes: 5, 6, 13, 


14 





3-127 



SUBB 

Subtract Memory from Accumulator with Borrow 



MCS-51 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 
Description: 



SUBB 

A Accumulator 

data address <= data address <= 255 

SUBB A,data address 



| 1001010T 



Data Address 



7 7 

(A) - (A) - (C) - (data address) 



c 


AC 


FO 


RS1 RSO OV 




P 


!• 


• 








• 




• 



PSW 

This instruction subtracts the contents of the Carry flag and the 
contents of the specified address from the contents of the 
accumulator. It places the result in the accumulator. 



3-128 



MCS-51 



SUBB 



Example: SUBBA.32H 


; Subtract 32H in memory from 
; accumulator 


Encoded Instruction: 




10010101 00110010 


7 7 




Before 


After 


Accumulator 


Accumulator 


| 00100110 


11010010 


7 


7 


(32H) 


(32H) 


| 01010011 


01010011 


7 


7 


Carry Flag 

LjlI 


Carry Flag 


Auxiliary Carry Flag 

LaJ 


Auxiliary Carry Flag 


Overflow Flag 

L±J 


Overflow Flag 

L±J 


Notes: S, 6, 8, 13, 14 





3-129 



SWAP 



MCS-51 



Exchange Nibbles in Accumulator 



Mnemonic: 


SWAP 


Operands: 


A Accumulator 


Format: 


SWAP A 


Bit Pattern: 






11000100 




7 


Operation: 


♦ 




hhhh INI 


Bytes: 1 
Cycles: 1 


♦ 




Flags: 


C AC F0 RS0RS1 OV P 







PSW 

Description: This instruction exchanges the contents of the low order nibble 
(0-3) with the contents of the high order nibble (4-7). 



Example: 



SWAPA 



; Swap high and low nibbles in the 
; accumulator. 



Encoded Instruction: 



11000100 




7 




Before After 


Accumulator 




Accumulator 


11010000 




00001101 


7 




7 


Noies: None 







i 



3-130 



MCS-51 



XCH 



Exchange Indirect Address with Accumulator 



Mnemonic: XCH 



Operands: 


A 
Rr 


Accumulator 
Register 0<=r<=1 


Format: 


XCHA,@Rr 




Bit Pattern: 








1 1 0001 1 r 





Operation: temp — ((Rr)) 
((Rr))-(A) 



(A)*- temp 



C AC F0 RS1 RSO OV 



I I I I l» 



Bytes: 1 
Cycles: 1 

Flags: 



PSW 

Description: This instruction exchanges the contents of the memory location 
addressed by the contents of register r with the contents of the 
accumulator. 

; Exchange the accumulator with 



Example: XCHA,@R0 


; Exchar 
; memoi 


Encoded Instruction: 




11000110 




7 




Before 


After 


Accumulator 


Accumulator 


00111111 


00011101 


7 


7 


Register 


Register 


01010010 


01010010 


7 


7 


(52H) 


(52H) 


| 00011101 


00111111 


7 


7 


Notes: 5,15 





3-131 



XCH 



MCS-51 



Exchange Register with Accumulator 



Mnemonic: XCH 



Operands: 

Format: 
Bit Pattern: 



A 
Rr 

XCH A,Rr 



Accumulator 
Register 0<=r<= 7 



11001rrr 



Operation: temp *- (Rr) 
(Rr)-(A) 
(A)*- temp 



Bytes: 1 
Cycles: 1 

Flags: 



C AC FO RS1 RSO OV 



i i i i i i t« 



PSW 

Description: This instruction exchanges the contents of register r with the 
contents of the accumulator . 

; Exchange register 6 with the 



Example: XCHA.R6 


; Exchar 
;accumi 


Encoded Instruction: 




11001100 




7 




Before 


After 


Accumulator 


Accumulator 


10011001 


10000000 


7 


7 


Register 6 


Register 6 


10000000 


10011001 


7 


7 


Note: S 





3-132 



MCS-51 



XCH 



Exchange Memory with Accumulator 



Mnemonic: XCH 



Operands: 

Format: 
Bit Pattern: 



A Accumulator 

data address <= data address <= 255 

XCH A,data address 



| 11000101 I Data Address | 
7 7 

Operation: temp *- (data address) 
(data address ) «- (A) 
(A) *- temp 

Bytes: 2 
Cycles: 1 



Flags: 



O AC F0 RS1 RS0 OV 



u± 



PSW 



Description: This instruction exchanges the contents of the specified data 
address with the contents of the accumulator. 



Example: XCHA,37H 

Encoded Instruction: 



; Exchange accumulator with the 
; contents of location 37H 



11000101 


00110111 




7 


7 







Before 






After 


Accumulator 






Accumulator 


| 01110111 | 


11110000 


7 


7 


(37H) 






(37H) 


| 11110000 


01110111 


7 


7 


Notes: 5,9 









3-133 



XCHD 



MCS-51 



Exchange Low Nibbles (Digits) of Indirect 
Address with Accumulator 



Flags: 



Mnemonic: 
Operands: 


XCHD 

A Accumulator 

Rr Register 0<=r<=1 


Format: 


XCHDA,@Rr 


Bit Pattern: 






1 1 01 01 1 r 




7 


Operation: 


temp ^((Rr)) 0-3 
((Rr)) 0-3 -(A) 0-3 
(A) 0-3*- temp 


Bytes: 1 
Cycles: 1 





C AC FO RS1 RS0 OV 



i m ii' 



PSW 



Description: This instruction exchanges the contents of the low order nibble (bits 
0-3) of the memory location addressed by the contents of register r 
with the contents of the low order nibble (bits 0-3) of the 
accumulator. 



3-134 



MCS-51 



XCHD 



Example: XCHD A, @R0 



; Exchange the accumulator with 
; memory 



Encoded Instruction: 



11010110 




7 




Before 


After 


Accumulator 


Accumulator 


00111111 


00111101 


7 


7 


Register 


Register 


01010010 


01010010 


7 


7 


(52H) 


(52H) 


00011101 


00011111 


7 


7 


Notes: 5,15 





3-135 



XRL 



MCS-51 



Logical Exclusive OR Immediate Data 
to Accumulator 



Mnemonic: 
Operands: 

Format: 
Bit Pattern 



XRL 

A 
data 

XRLA,#tfate 



Accumulator 

-256 <= date <= +255 





01100100 | Immediate Data 




7 7 


Operation: 


(A)^(A)XORcfate 


Bytes: 2 
Cycles: 1 




Flags: 


C AC F0 RS1 RS0 OV P 




i in* 



PSW 

Description: This instruction exclusive ORs the immediate data value to the 
contents of the accumulator. Bit n of the result is if bit n of the 
accumulator equals bit n of the data value; otherwise bit n is 1. It 
places the result in the accumulator. 



Example: XRLA,#0FH 

Encoded Instruction: 



; Complement the low order nibble 



01100100 


00001111 




7 


7 







Before 






After 


Accumulator 






Accumulator 


| 01110111 j 


01111000 


7 


7 


Notes: 4, 5 









3-136 



MCS-51 



XRL 



Logical Exclusive OR Indirect Address 
to Accumulator 



Mnemonic: 


XRL 


Operands: 


A Accumulator 
Rr 0<=Rr<=1 


Format: 


XRLA,@Rr 


Bit Pattern: 






| 01 1 001 1 r 




7 


Operation: 


(A)-(A)XOR((Rr)) 


Bytes: 1 
Cycles: 1 




Flags: 


C AC F0 RS1 RSO OV P 




!• 



PSW 

Description: This instruction exclusive ORs the contents of the memory location 
addressed by the contents of register r to the contents of the 
accumulator. Bit n of the result is if bit n of the accumulator 
equals bit n of the addressed location; otherwise bit n is 1 . It places 
the result in the accumulator. 



Example: XRL A, @R0 



; XOR indirect address with 
; accumulator 



Encoded Instruction: 



01100110 




7 




Before 


After 


Accumulator 


Accumulator 


| 00101000 


00101001 | 


7 


7 


Register 


Register 


| 01010010 


01010010 


7 


7 


(52H) 


(52H) 


| 00000001 


00000001 


7 


7 


Notes: 5,15 





3-137 



XRL 



MCS-51 



Logical Exclusive OR Register to Accumulator 



Mnemonic: 


XRL 


Operands: 


A Ac( 
Rr Re 


Format: 


XRLA,Rr 


Bit Pattern: 






01101rrr 




7 


Operation: 


(A) +- (A) XOR (Rr) 


Bytes: 1 
Cycles: 1 





Accumulator 
Register 0<=r<= 7 



Flags: 



C AC FO RS1 RSO OV 



• 



PSW 



Description: This instruction exclusive ORs the contents of register r to the 
contents of the accumulator. Bit n of the result is if bit n of the 
accumulator equals bit n of the specified register; otherwise bit n is 
1 . It places the result in the accumulator. 



Example: XRLA.R4 


; XOR R- 


Encoded Instruction: 




| 01101100 




7 




Before 


After 


Accumulator 


Accumulator 


10010001 


01110010 


7 


7 


Register 4 


Register 4 


11100011 


11100011 


7 


7 


Note: 5 





3-138 



MCS-51 



XRL 



Logical Exclusive OR Memory to Accumulator 



XRL 

A Accumulator 

data address <= data address <= 255 

XRL A,data address 



01100101 



Data Address 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction exclusive ORs the contents of the specified data 
address to the contents of the accumulator. Bit n of the result is if 
bit n of the accumulator equals bit n of the addressed location; 
otherwise bit n is 1 . It places the result in the accumulator. 



7 7 

(A) - (A) XOR {data address) 

C AC F0 RS1 RS0 OV P 



• 



Example: XRLA,37H 


; XOR the contents of location 37H 
; with accumulator 


Encoded Instruction: 




01100101 00110111 




7 7 




Before 


After 


Accumulator 


Accumulator 


01111111 


11110111 


7 


7 


(37H) 


(37H) 


10001000 


10001000 


7 


7 


Notes: 4,8 





3-139 



XRL 



MCS-51 



Logical Exclusive OR Immediate Data to Memory 



Mnemonic: 
Operands: 

Format: 
Bit Pattern: 

Operation: 

Bytes: 3 
Cycles: 2 

Flags: 
Description: 



XRL 

data address <= data address <= 255 
data -256 <= data <= + 255 

XRL data address Jkdata 



01100011 | Data Address 



Immediate Data 



7 7 7 

(data address) «- (data address) XOR data 



c 


AC 


F0 


RS1 RS0 OV 




P 



















PSW 

This instruction exclusive ORs the immediate data value to the 
contents of the specified data address. Bit n of the result is if bit n 
of the specified address equals bit n of the data value; otherwise, 
bit 17 is 1 . It places the result in data memory at the specified 
address. 



Example: XRL P1J51H 

Encoded Instruction: 



; XOR 51 H with the contents of Port 1 



01100011 


10010000 


01010001 


7 


7 





7 


Before 






After 


Port 1 (90H) 






Port1(90H) 


01110110 


11100110 


7 


7 


Notes: 4,9 









3-140 



MCS-51 



XRL 



Logical Exclusive OR Accumulator to Memory 



Mnemonic: 


XRL 


Operands: 


data address <= data addre 
A Accumulator 


Format: 


XRL data address , A 


Bit Pattern: 






0110 010 Data Address 



7 7 

(data address) *- (data address) XOR A 



Operation: 

Bytes: 2 
Cycles: 1 

Flags: 



PSW 

Description: This instruction exclusive ORs the contents of the accumulator to 
the contents of the specified data address. Bit n of the result is if 
bit n of the accumulator equals bit n of the specified address; 
otherwise bit n is 1. It places the result in data memory at the 
specified address. 



c 


AC 


F0 


RS1 RS0 


OV 




P 



















Example: 


XRL 10H.A 




; XOR the contents of 10H with the 
; accumulator 


Encoded Instruction: 






01100010 


00010000 


7 7 







Before 




After 


Accumulator 






Accumulator 


11110000 | 


11110000 | 


7 


7 


(10H) 






(10H) 


00110001 


11000001 | 


7 


7 


Note: 9 









3-141 



Instruction Set MCS-5 1 



Notes 

1 . The low-order byte of the Program Counter is always placed on the stack first, 
followed by the high order byte. 

2. The Stack Pointer always points to the byte most recently placed on the stack. 

3. On the 8051 the contents of the Stack Pointer should never exceed 127. If the 
stack pointer exceeds 127, data pushed on the stack will be lost, and undefined 
data will be returned. The Stack Pointer will be incremented normally even 
though data is not recoverable. 

4. The expression used as the data operand must evaluate to an eight-bit number. 
This limits the range of possible values in assembly time-expressions to between 
-256 and +255 inclusive. 

5. The Parity Flag, PSW.O, always shows the parity of the accumulator. If the 
number of l's in the accumulator is odd, the parity flag is 1; otherwise, the 
parity flag will be 0. 

6. All addition operations affect the Carry Flag, PSW.7, and the Auxiliary Carry 
flag, PSW.6. The Carry flag receives the carry out from the bit 7 position (Most 
Significant Bit) in the accumulator. The Auxiliary Carry flag receives the carry 
out from the bit 3 position. Each is either set or cleared with each ADD 
operation. 

7. The overflow flag (OV) is set when an operation produces an erroneous result 
(i.e. the sum of two negative numbers is positive, or the sum of two positive 
numbers is negative). OV is updated with each operation. 

8. If one of the I/O ports is specified by the data address, then data will be taken 
from the port input pins. 

9. If one of the I/O ports is specified by the data address, then data will be taken 
from, and returned to, the port latch. 

10. The code address operand must be within the range of -128 and +127 inclusive 
of the incremented program counter's value. 

11. The last byte of the encoded instruction is treated as a two's complement 
number, when it is added to the program counter. 

12. The Program Counter is always incremented before the add. 

13. The auxiliary carry flag is set if there is a borrow from bit 3 of the accumulator; 
otherwise, it is cleared. 

14. The overflow flag (OV) is set when an operation produces an erroneous result 
(i.e. a positive number is subtracted from a negative number to produce a 
positive result, or a negative number is subtracted from a positive number to 
produce a negative result). OV is cleared with each correct operation. 

15. On the 8051 the contents of the register used in the indirect address should not 
exceed 127. When the contents of the register is 128 or greater, source operands 
will return undefined data, and destination operands will cause data to be lost. 
In either case, the program will continue with no change in execution time or 
control flow. 

16. If an I/O port is specified as the source operand, then the the port pins will be 
read. If an I/O port is the destination operand, then the port latch will receive 
the data. 

17. If the stack pointer is 128 or greater, then invalid data will be returned on a 
POP or return. 
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CHAPTER 4 
ASSEMBLER DIRECTIVES 



This chapter describes the assembler directives. It shows how to define symbols and 
how to control the placement of code and data in program memory. 



Introduction 

The MCS-51 assembler has several directives that permit you to set symbol values, 
reserve and initialize storage space, and control the placement of your code. 

The directives should not be confused with instructions. They do not produce exe- 
cutable code, and with the exception of the DB and DW directives, they have no 
direct effect on the contents of code memory. What they do is change the state of the 
assembler, define user symbols, and add information (other than pure object code) 
to the object file (e.g., segment definitions). 

The directives are divided into the following categories: 

Symbol Definition 
SEGMENT 
EQU 
SET 
DATA 
IDATA 
XDATA 
BIT 
CODE 

Storage Initialization/Reservation 
DS 
DB 
DW 
DBIT 

Program Linkage 
PUBLIC 
EXTRN 

NAME 

Assembler State Control 
ORG 
END 
Segment Selection Directives 

RSEG 

CSEG 

DSEG 

XSEG 

ISEG 

BSEG 
USING 

The MCS-51 assembler is a two-pass assembler. In the first pass, symbol values are 
determined, and in the second, forward references are resolved, and object code is 
produced. This structure imposes a restriction on the source program: expressions 
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which define symbol values (see Symbol Definition Directives) and expressions 
which control the location counter (see ORG, DS, and DBIT directives) may not 
have forward references . 



The Location Counter 

The location counter in ASM51 is a pointer to the address space of the active seg- 
ment. When a segment is first activated, the location counter is (unless a base 
address was specified using the segment select directives). The location counter is 
changed after each instruction by the length of the instruction. You can change its 
value with the ORG directive, which sets a new program origin for statements that 
follow it. The storage initialization and reservation directives (DS, DB, DW, and 
DBIT) change the value of the location counter as statements are encountered within 
a segment. If you change segments and later return to that segment, the location 
counter is restored to its previous value. Whenever the assembler encounters a label, 
it assigns to the label the current value of the location counter and the type of the 
current segment. 

The dollar sign ($) indicates the value of the active segment's location counter. 
When you use the location counter symbol, keep in mind that its value changes with 
each instruction, but only after that instruction has been completely evaluated. If 
you use $ in an operand to an instruction or a directive, it represents the code 
address of the first byte of that instruction. 

MSG: DB MSG__LENGTH,THISIS A MESSAGE' 
MSG__LENGTH EQU $-MSG-1 ;message length 



Symbol Names 

A symbol name must begin with a letter or a special character (either ? or ), 

followed by letters, special characters, or digits. 

You can use up to 255 characters in a symbol name, but only the first 31 characters 
are significant. A symbol name may contain upper- or lower-case characters, but the 
assembler converts to upper-case characters for internal representation. So, to 
ASM51, "buffer" is the same as "BUFFER" and the name 

"_A_THIRTY_ONE_CHARACTER_STRING_" 
is the same as the name 

,, _A_THIRTY_ONE_CHARACTER_STRING_PLUS_THIS." 

although the strings are different. 

The instruction mnemonics, assembly-time operators, predefined bit and data 
addresses, segment attributes, and assembler directives may not be used as user- 
defined symbol names. For a complete list of these reserved words, refer to 
Appendix F. 

Statement Labels 

A label is a symbol. All of the rules for forming symbol names apply to labels. A 
statement label is the first field in a line, but it may be preceded by any number of 
tabs or spaces. You must place a colon (:) after a label to identify it as a label. Only 
one label is permitted per line. 
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Labels are allowed only before empty statements, machine instructions, data initial- 
ization directives (DB and DW), and storage reservation directives (DS and DBIT). 
Simple names (without colons) can only precede symbol definition directives (EQU, 
SET, CODE, DATA, IDATA, XDATA, BIT, and SEGMENT). All other 
statements may not be preceded by labels or simple names. 

When a label is defined, it receives a numeric value and segment type. The numeric 
value will always be the current value of the location counter of the currently 
selected segment at the point of use. The value of the label will be relocatable or 
absolute depending on the relocatability of the current segment. The segment type 
will be equivalent to the segment type of the current segment. 

Several examples of lines containing labels are shown below: 

LABEL1: DS 1 

LABEL2: ;This line contains no instruction; it is an empty statement 

LAB3: DB 27,33, 'FIVE' 

MOV_PROC: MOV DPTR,#LABEL3 

You can use labels like any other symbol, as a memory address, or a numeric value 
in an assembly-time expression. A label, once defined, may not be redefined. 



Symbol Definition 

The symbol definition directives allow you to create symbols that can be used to 
represent segments, registers, numbers, and addresses. None of these directives may 
be preceded by a label . 

Symbols defined by these directives may not have been previously defined and may 
not be redefined by any means. The SET directive is the only exception to this. 



SEGMENT Directive 

The format for the SEGMENT directive is shown below. Note that a label is not 
permitted. 

relocatable_segment_name SEGMENT segment_type [relocation^type] 

The SEGMENT directive allows you to declare a relocatable segment, assign a set of 
attributes, and initialize the location counter to zero (0). 

Although the name of a relocatable segment must be unique in the module, you can 
define portions of the segment within other modules and let RL51 combine them. 
When you do this, the segment type attributes must all be the same and the reloca- 
tion types must either be the same or be of two types, one of which is UNIT (see 
below). In the latter case, the more restrictive type will override. 

The segment type specifies the address space where the segment will reside. The 
allowable segment types are: 

• CODE— the code space 

• XDATA— the external data space 

• DATA— the internal data space accessible by direct addressing (0 to 127) 

• IDATA— the entire internal data space accessible by indirect addressing (0 to 
127) 

• BIT— the bit space (overlapping locations 32 to 47 of the internal data space) 



4-3 



Assembler Directives MCS-51 



The relocation type, which is optional, defines the relocation possibilities to be 
assigned by the RL51 . The allowable relocation types are: 

• PAGE— specifies a segment whose start address must be on a 256-byte page 
boundary. Allowed only with CODE and XDATA segment types. 

• INP AGE— specifies a segment which must be contained in a 256-byte page. 
Allowed only with CODE and XDATA segment types. 

• INBLOCK— specifies a segment which must be contained in a 2048-byte block. 
Allowed only for CODE segments. 

• BITADDRESSABLE— specifies a segment which will be relocated by RL51 
within the bit space on a byte boundary. Allowed only for DATA segments; 
limited to a 16-byte maximum size. 

• UNIT— specifies a segment which will be aligned on a unit boundary. This will 
be a byte boundary for CODE, XDATA, DATA, and IDATA segments and a 
bit boundary for BIT segments. This relocation type is the default value. 

NOTE 

When used in expressions, the segment symbol stands for the base 
address of the combined segment. 

Any DATA or IDATA segments may be used as a stack (there is no explicit stack 
segment). 



For example, 




STACK SEGMENT 


IDATA 


RSEG 


STACK 


DS 


10H 



;Reserve 16 bytes for stack 



MOV SP,#STACK-1 -.Initialize stack pointer 

EQU Directive 

The format for the EQU directive is shown below. Note that a label is not permitted. 

symbol_name EQU expression 
or 

symbol__name EQU special__assembler__symbol 

The EQU directive assigns a numeric value or special assembler symbol to a 
specified symbol name. The symbol name must be a valid ASM51 symbol as 
described above. 

If you assign an expression to the symbol, it must be an absolute or simple 
relocatable expression with no forward references. You can use the symbol as a data 
address, code address, bit address, or external data address depending on the seg- 
ment type of the expression, i.e., the symbol will have the segment type of the 
expression. If the expression evaluates into NUMBER, the symbol will be con- 
sidered as such and will be allowed to be used everywhere. 

The special assembler symbols A, RO, Rl, R2, R3, R4, R5, R6, and R7 can be 
represented by user symbols defined with the EQU directive. If you define a symbol 
to a register value, it will have a type "REG". It can only be used in the place of that 
register in instruction operands. 
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A symbol defined by the EQU directive cannot be defined anywhere else. 
The following examples show several uses of EQU: 



ACCUM 


EQU 


A 


; define ACCUM to stand for A 
; (the 8051 accumulator) 


N27 


EQU 


27 


; set N27 to equal 27 


HERE 


EQU 


$ 


; set HERE to current location counter 
; value 


DADDR1 


EQU 


DADDRO+1 


; Assuming DADDRO is a DATA address 
; DADDR1 will also be a DATA address 



SET Directive 

The format for the SET directive is shown below. 

symbol__name SET expression 
or 

symbol__name SET special__assembler_symbol 

The SET directive operates similiar to EQU. The difference is that the defined sym- 
bol can be redefined later, using another SET directive. 

NOTE 

You cannot set a symbol which was equated and you cannot equate a sym- 
bol which was set. 

The following examples show several uses of SET: 



COUNT 


SET 





initialize absolute counter 


COUNT 


SET 


COUNT+1 


.Increment absolute counter 


HALF 


SET 


WHOLE/2 


;Give half of WHOLE to HALF 
;the remainder is discarded 


H20 


SET 


32 


;Set H20 to 32 


INDIRECT 


SET 


R1 


;Set INDIRECT to R1 



BIT Directive 

The format for the BIT directive is shown below. 

symbol__name BIT bit_address 

The BIT directive assigns a bit address to the specified symbol name. 

Bit address format is described in Chapter 2. The symbol gets the segment type BIT. 
A symbol defined as BIT may not be redefined elsewhere in the program. 

The following examples show several uses of BIT: 



CONTROL: 



RSEG DATA__SEG ;A relocatable bit addressable segment 
DS 1 



ALARM 


BIT 


CONTROL.O 


;B«t in a relocatable byte 


OPEN_DOOR 


BIT 


ALARM + 1 


;The next bit 


RESET__BOARD 


BIT 


060H 


;An absolute bit 
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DATA Directive 

The format for the DATA directive is shown below. 

symbol__name DATA expression 

The DATA directive assigns an on-chip data address to the specified symbol name. 
The expression must be an absolute or simple relocatable expression. Absolute 
expressions greater than 127 must specify a defined hardware register (see Chapter 
1). The segment type of the expression must be •either DATA or NUMBER. The 
symbol gets the segment type DATA. 

A symbol defined by the DATA directive may not be redefined elsewhere in the 
program. 

The following examples show several uses of DATA: 
CONIN DATA SBUF 



TABLE__BASE DATA 70H 



TABLE_END DATA 
REL_TABLE DATA 



7FH 



REL_START+1 



;define CONIN to address 

;the serial port buffer 

-.define TABLE_BASE to be 

;at location 70H 

;define TABLE_END to be 

;attopofRAM(7FH) 

; Define REI TABLE to be a 

relocatable symbol (assuming 
;REL_START is) 



XDATA Directive 

The format for the XDATA directive is shown below. 

symbol— name XDATA expression 

The XDATA directive assigns an off-chip data address to the specified symbol 
name. The expression must be an absolute or simple relocatable expression. If the 
expression does not evaluate to a number, its segment type must be XDATA. The 
symbol gets the segment type XDATA. A symbol defined by the XDATA directive 
may not be redefined elsewhere in the program. 

The following examples show several uses of XDATA: 



;Define DATE to 1D0H off XSEG1 base 
.define TIME to be 5 bytes after DATE 
.define PLACE to be 3 bytes after TIME 





RSEG XSEG1 




ORG 100H 


DATE: 


DS 5 


TIME 


XDATA DATE + 5 


PLACE 


XDATA TIME + 3 



IDATA Directive 

The format for the IDATA directive is shown below. 

symbol__name IDAT A expression 

The IDATA directive assigns an indirect internal data address to the specified sym- 
bol name. The expression must be an absolute or simple relocatable expression. 
Absolute expressions may not be larger than 127 for the 8051. The segment type of 
the expression must be either IDATA or NUMBER. The symbol gets the segment 
type IDATA. A symbol defined by the IDATA directive may not be redefined 
elsewhere in the program. 
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The following examples show several uses of IDATA: 

BUFFER IDATA 60H 

BUFFER_LEN EQU 20H 

BUFFER_END IDATA BUFFER + BUFFER_LEN-1 



CODE Directive 

The format for the CODE directive is shown below. 

symbol^name CODE expression 

The CODE directive assigns a code address to the specified symbol name. The 
expression must be an absolute or simple relocatable expression. If the expression 
does not evaluate to a number, its segment type must be CODE. The symbol gets a 
segment type of CODE. A symbol defined by the CODE directive may not be 
redefined elsewhere in the program. 

The following examples show several uses of the CODE directive: 

RESTART CODE 00H 

INT__VEC0 CODE 03H 

INT_VEC1 CODE OBH 

INT_VEC2 CODE 1BH 



Storage Initialization and Reservation 

The storage initialization and reservation directives are used to initialize and reserve 
space in either word, byte, or bit units. The space reserved starts at the point indi- 
cated by the current value of the location counter in the currently active segment. 
These directives may be preceded by a label. 



DS Directive 

The format of the DS directive is as follows: 

[label:] DS expression 

The DS directive reserves space in byte units. It can be used in any segment except a 
BIT type segment. The expression must be a valid assembly- time expression with no 
forward references and no relocatable or external references. When a DS statement 
is encountered in a program, the location counter of the current segment is incre- 
mented by the value of the expression. The sum of the location counter and the 
specified expression should not exceed the limitations of the current address space, 
or those set by the current relocation type. 

DBIT Directive 

The format of the DBIT directive is as follows: 

[label:] DBIT expression 

The DBIT directive reserves a space in bit units. It can be used only in a BIT type 
segment. The expression must be a valid assembly-time expression with no forward 
references. When the DBIT statement is encountered in a program, the location 
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counter of the current (BIT) segment is incremented by the value of the expression. 
Note that in a BIT segment, the basic unit of the location counter is in bits rather 
than bytes. 



DB Directive 

The format for a DB directive is shown below: 

[label:] DB expressionist 

The DB directive initializes code memory with byte values. Therefore, a CODE type 
segment must be active. The expression list is a series of one or more byte values or 
strings separated by commas(,). A byte value can be represented as an absolute or 
simple relocatable expression or as a character string. Each item in the list (expres- 
sion or character string) is placed in memory in the same order as it appears in the 
list. 

The DB directive permits character strings longer than 2 characters, but they must 
not be part of an expression (i.e., you cannot use long character strings with an 
operator, including parentheses). If you specify the null character string as an item 
in the list (not as part of an expression), it generates no data. If the directive has a 
label, the value of the label will be the address of the first byte in the list. 

The following examples show several ways you can specify the byte value list in a DB 
directive: 

AGE'.DB l MARY , l 0,27, , BILL , l 0,25,VOE , l l 21 > 4 SUE , ,0,18 
; This DB statement lists the names (character strings) 
; and ages (numbers) that have been placed in a list (the label 
; AGE will address the "M" in "MARY") 

PRIMES: 081,2,3,5,7,11,13,17,19,23,29,31,37,41,43,47,53 
; This DB lists the first 17 prime numbers. 
; (PRIMES is the address of 1) 

QUOTE: DB 'THIS IS A QUOTE"' ; This is an example of how to put the 

; quote character in a character 
; string. 



DW Directive 

The format for a DW statement is shown below: 

[label:] DW expressionist 

The DW directive initializes code memory with a list of word (16-bit) values. 
Therefore, a CODE type segment must be active. The expression list can be a series 
of one or more word values separated by commas(,). Word values can be absolute or 
simple relocatable expressions. If you use the location counter ($) in the list, it 
evaluates to the code address of the word being initialized. Unlike the DB directive, 
no more than two characters are permitted in a character string, and the null 
character string evaluates to 0. 

Each item in the list is placed in memory in the same order as it appears in the list, 
with the high order byte first, followed by the low order byte (unlike the way it is 
handled by the ASM80/86). If the statement has a label, the value of the label will 
address the first value in the list (i.e., the high order byte of the first word). 
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The following examples show several ways you can specify the word value list in a 
DW directive: 

ARRIVALS: DW 710,'AM\ 943, 'AM', 315,'PM\941'PM' 
; This DW lists several flight arrivals. 
; The numbers and characters are encoded 
; consecutively. 

INVENTORY: DW 'F', 27869, 'G\ 34524, 'X', 27834 

; This list of characters and numeric 
; values will be encoded with the high 
; order byte of each character string 
; filled with zeros. INVENTORY will 
; address a zero byte. 

JUMP_TABLE DW GO_PROC,BREAK_PROC,DISPLAY_PROC 

; A jump table is constructed by listing 

; the procedure addresses 
DW $, $-2, $-4, $-6 ; This DW statement initializes four 

; words of memory with the same value. 

; (The location counter is incremented 

; by 2 for each item in the list.) 



Program Linkage 



Program linkage directives allow the separately assembled modules to communicate 
by permitting intermodule references and the naming of modules. 



PUBLIC Directive 

The format for the PUBLIC directive is shown below: 

PUBLIC list^.of_names 

The PUBLIC directive allows symbols to be known outside the currently assembled 
module. If more than one name is declared public, the names must be separated by 
commas (,). Each symbol name may be declared public only once in a module. Any 
symbol declared PUBLIC must have been defined somewhere else in the program. 
Predefined symbols and symbols defined as registers or segments (declared via the 
SEGMENT directive) may not be specified as PUBLIC . 

The following examples show several uses of the PUBLIC directive: 

PUBLIC put_crlf, put_string, put_data_str 
PUBLIC ascbin, binasc 
PUBLIC liner 

EXTRN Directive 

The format for the EXTRN directive is shown below: 

EXTRN [segment__type(lisL_of_-Symbol— names)), ... 

The EXTRN directive lists symbols to be referenced in the current module that are 
defined in other modules. This directive may appear anywhere in the program. 
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The list of external symbols must have a segment type associated with each symbol 
on the list. (The segment types are CODE, XDATA, DATA, IDATA, BIT, and 
NUMBER, i.e., a typeless symbol.) The segment type indicates the way a symbol 
may be used (e.g., a CODE type external symbol may be used as a target to a jump 
instruction but not as the target of a move instruction). At link and locate time, the 
segment type of the corresponding public symbol must match the segment type of 
the EXTRN directive. This match is accomplished if either type is NUMBER or if 
both types are the same. 



The following examples show several uses of the EXTRN directive: 

EXTRN CODE (put_crlf, put_string, get__num), DATA (count,tota!) 
EXTRN CODE (binasc, ascbin), NUMBER (table_size) 



NAME Directive 

The format for the NAME directive is shown below: 

NAME modufe^name 

The NAME directive is used to identify the current program module. All the rules 
for naming apply to the module name. The NAME directive should be placed before 
all directives and machine instructions in the module. Only comments and control 
lines can precede the NAME directive. 

If you choose not to use the name directive, the root (i.e., the file name without both 
the drive and the extension identifiers) of the source filename is used as the default. 

NOTE 

When filename roots start with a digit and the NAME directive is not 
specified, the module name cannot be used in the RL51 module list (such a 
module name is illegal f or RL5 1 ) . 

The symbol used in the NAME directive is considered undefined for the rest of the 
program unless it is specifically defined later. 

The following examples show several uses of the NAME directive: 

NAME track 
NAME compass 
NAMEchapter_45 



Assembler State Controls 
END Directive 

Every program must have an END statement. Its format is shown below: 

END 

The END statement must not have a label, and only a comment may appear on the 
line with it. The END statement should be the last line in the program; otherwise, 
this will produce an error. 
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ORG Directive 

The ORG directive is used to alter the assembler's location counter to set a new pro- 
gram origin for statements that follow the directive. 

The format for the ORG directive is shown below. Note that a label is not permitted. 

ORG expression 

The expression should be an absolute or simple relocatable expression referencing 
the current segment and containing no forward references. 

When the ORG directive is encountered in a program, the value of the expression is 
computed as the new value of the location counter specifying the address at which 
the next machine instruction or data item will be assembled in the current selected 
segment. If the current segment is absolute, the value will be an absolute address in 
the current segment; if the segment is relocatable, the value will be offset from the 
base address of the instance of the segment in the current module. 

The ORG directive modifies the location counter; it does not generate a new seg- 
ment. That is, when the location counter is incremented from the current value, the 
space between the previous and the current location counter becomes part of the cur- 
rent segment. 

In an absolute segment, the location counter must not be decremented to an address 
below the beginning of that segment. 

Examples: 

ORG ($ + 10H)AND0FFF0H ; set location counter to next 

; 16-byte boundary 
ORG 50 ; set location counter to 50 



Segment Selection Directives 

The segment selection directives will divert the succeeding code or data into the 
selected segment until another segment is selected by a segment selection directive. 
The directives may select a previously defined relocatable segment, or optionally 
create and select absolute segments. 

The format for relocatable segment selection directives is shown below. Note that a 
label is not permitted and that the name must be previously defined as a segment 
name. 

RSEG segment name 

The format for absolute segment select directives is shown below. Note that a label is 
not permitted here either. 

'cSEG^ 

XSEG I 

DSEG / [AT absolute_address] 

ISEG I 
^BSEG/ 

CSEG, DSEG, ISEG, BSEG, and XSEG select an absolute segment within the code, 
internal data, indirect internal data, bit, or external data address spaces, respec- 
tively. If you choose to specify an absolute address (by including "AT absolute 
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address"), the assembler terminates the last absolute segment, if any, of the 
specified segment type, and creates a new absolute segment starting at that address . 
If you do not specify an absolute address, the last absolute segment of the specified 
type is continued. If no absolute segment of this type was selected and the absolute 
address is omitted, a new segment is created starting at location 0. You cannot use 
any forward references and the start address must be an absolute expression. 

Each segment has its own location counter; this location counter is always set to in 
the initial state. The default segment is an absolute code segment; therefore, the 
initial state of the assembler is location in the absolute code segment. When 
another segment is chosen for the first time, the location counter of the former seg- 
ment retains the last active value. When that former segment is reselected, the loca- 
tion counter picks up at the last active value. You can use the ORG directive to 
change the location counter within the currently selected segment. 



DATA_SEG1 


SEGMENT 


DATA 




; A relocatable data segment 


CODE_SEG1 


SEGMENT 


CODE 




; A relocatable code segment 




BSEG AT70H 




; Absolute bit segment 


DECIMAL_MODE 


: DBIT 


1 




; Absolute bit 


CHAR__MODE: 


DBIT 


1 








RSEG 


DATA_ 


_SEG1 


; Select the relocatable data segment 


TOTAL1: 


DS 


1 






COUNT1: 


DS 


1 






COUNT__W: 


DS 


2 








RSEG 


CODE_ 


_SEG1 


; Select the relocatable code segment 


BEGlN_CODE: 











USING Directive 

The format for the USING directive is shown below. Note that a label is not 
permitted. 

USING expression 

This directive notifies the assembler of the register bank that is used by the subse- 
quent code. The expression is the number (between and 3 inclusive) which refers to 
one of four register banks. 

The USING directive allows you to use the predefined symbolic register addresses 
(ARO through AR7) instead of their absolute addresses. In addition, the directive 
causes the assembler to reserve a space for the specified register bank . 

Examples: 

USING 3 

PUSH AR2 ;Push register 2 of bank 3 

USING 1 

PUSH AR2 ;Push register 2 of bank 1 

Note that if you equate a symbol (e.g., using EQU directive) to an ARi symbol, the 
user-defined symbol will not change its value as a result of the subsequent USING 
directive. 
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Introduction 

The Macro Processing Language (MPL) of ASM51 is a string replacement facility. 
It permits you to write repeatedly used sections of code once and then insert that 
code at several places in your program. If several programmers are working on the 
same project, a library of macros can be developed and shared by the entire team. 
Perhaps MPL's most valuable capability is conditional assembly— with all 
microprocessors, compact configuration dependent code is very important to good 
program design. Conditional assembly of sections of code can help to achieve the 
most compact code possible. 

This chapter documents MPL in three parts. The first section describes how to 
define and use your own macros. The second section defines the syntax and 
describes the operation of the macro processor's built-in functions. The final section 
of the chapter is devoted to advanced concepts in MPL. 

The first two sections give enough information to begin using the macro processor. 
However, sometimes a more exact understanding of MPL's operation is needed. 
The advanced concepts section should fill those needs. 

Don't hesitate to experiment. MPL is one of the most powerful and easy to use tools 
available to programmers. 



Macro Processor Overview 

The macro processor views the source file in very different terms than the assembler. 
Figure 5-1 illustrates these two different views of the input file. To the assembler, the 
source file is a series of lines— control lines, instruction lines, and directive lines. To 
the macro processor, the source file is a long string of characters. 

The figure below shows these two views of the source file. 
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Figure 5-1 . Macro Processor versus Assembler- 
Two Different Views of a Source File 



937-15 



5-1 



Macro Processing Language MCS-5 1 

All macro processing of the source file is performed before your code is assembled. 
Because of this independent processing of macros and assembly of code, we must 
differentiate between macro-time and assembly-time. At macro-time, assembly 
language symbols— labels, SET and EQU symbols, and the location counter are not 
known. Similarly, at assembly-time, no information about macros is known. 

The macro processor scans the source file looking for macro calls. A macro call is a 
request to the processor to replace the call pattern of a built-in or user-defined 
macro with its return value. 

When a macro call is encountered, the macro processor expands the call to its return 
value. The return value of a macro is then placed in a temporary workfile, and the 
macro processor continues. AH characters that are not part of a macro call are 
copied into the temporary workfile. 

The return value of a macro is the text that replaces the macro call. The return value 
of some macros is the null string. (The null string is a character string containing no 
characters.) In other words, when these macros are called, the call is removed from 
the input stream, and the assembler never sees any evidence of its presence. This is 
particularly useful for conditional assembly. 

Introduction to Creating and Calling Macros 

The macro processor is a character string replacement facility. It searches the source 
file for a macro call, and then replaces the call with the macro's return value. A % 
signals a macro call. % is the default metacharacter. The metacharacter must 
precede a macro call. Until the macro processor finds a metacharacter, it does not 
process text. It simply passes the text from the source file to a workfile, which is 
eventually assembled. 

Since MPL only processes macro calls, it is necessary to call a macro in order to 
create other macros. The built-in function DEFINE creates macros. Built-in func- 
tions are a predefined part of the macro language, so they may be called without 
prior definition. The general syntax for DEFINE is: 

%[*]DEF\HE(call-pattem)[local-symbol-llst](macro-body) 

DEFINE is the most important MPL built-in function. This section of the chapter is 
devoted to describing this built-in function. Each of the symbols in the syntax above 
{call-pattern, local-symbol-list, and macro-body) are thoroughly described in the 
pages that follow. In some cases we have abbreviated this general syntax to 
emphasize certain concepts. 

Creating Simple Macros 

When you create a simple macro, there are two parts to a DEFINE call: the call pat- 
tern and the macro body. The call pattern defines the name used when the macro is 
called; the macro body defines the return value of the call. 

The syntax of a simple macro definition is shown below: 

%*DEFINE (call-pattern) (macro-body) 

The '%' is the metacharacter that signals a macro call. The '*' is the literal 
character. The literal character is normally used when defining macros. The exact 
use of the literal character is discussed in the advanced concepts section of this 
chapter. 
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When you define a simple macro, the call-pattern is a macro identifier. It follows the 
metacharacter, when you call the macro in the source file. The rules for macro iden- 
tifiers are the same as ASM51 symbol names. 

• The identifier must begin with an alphabetic character (A,B,C,...,Z or 
a,b,c,...,z) or a special character (a question mark ? or an underscore 
character ( )). 

• The remaining characters may be alphabetic, special, or decimal digits 
(0,1,2,...,9). 

• Only the first 31 characters of a macro identifier are recognized as the unique 
identifier name. Upper and lower case characters are not distinguished in a 
macro identifier. 

The macro-body is usually the return value of the macro call. However, the macro- 
body may contain calls to other macros. If so, the return value is actually the fully 
expanded macro body, including the calls to other macros. When you define a 
macro using the syntax shown above, macro calls contained in the body of the 
macro are not expanded, until you call the macro. 

The syntax of DEFINE requires that left and right parentheses surround the macro- 
body. For this reason, you must have balanced parenthesis within the macro body 
(i.e., each left parenthesis must have a succeeding right parenthesis, and each right 
parenthesis must have a preceding left parenthesis). We call character strings that 
meet these requirements balanced-text. 

To call a macro, you use the metacharacter followed by the call-pattern for the 
macro. (The literal character is not needed when you call a user-defined macro.) The 
macro processor will remove the call and insert the return value of the call. If the 
macro body contains any call to other macros, they will be replaced with their return 
value. 

Once a macro has been created, it may be redefined by a second call to DEFINE. 

The three examples below show several macro definitions. Their return values are 
also shown. 



Example 1 : 

Macro definition at the top of program: 

%*DEFINE(MOVE)( 

MOVA,@R1 
MOV@R0,A 
INCR1 
INCRO 
) 

Macro call as it appears in program (* literal character is not needed when you call 
the user-defined macro): 

POP ACC 
MOVR1,A 
POP ACC 
MOV R0,A 
%MOVE 
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The program after the macro processor makes the expansion: 

POPAGC 
MOVR1.A 
POPACC 
MOVR0,A 



MOVA,@R1 
MOV @R0,A 
INCR1 
INCRO 



this is the return value 



Example 2: 

Macro definition at the top of the program: 



%* DEFINE (MULT) ( 



MULAB 
JNBOV,($ + 6) 
LCALLOVFL_ERR 



) 



The macro call as it appears in original program body: 

MOVB,@R1 
MOVA,@R0 
%MULT 
MOV@R0,A 

The program after macro expansion: 

MOVB,@R1 
MOVA,@R0 



MULAB 
JNBOV,($ + 6) 
LCALLOVFL_ERR ) 



. this is the return value 



MOV@R0,A 



Example 3: 

Here is a macro that calls MULT to multiply 5 bytes: 

%*DEFINE(MULT_5)( 
MOVR7,#5 
MOVR0,#ADDR1 
MOVR1,#ADDR2 
TOP: MOVB,@R1 

MOVA,#R0 
%MULT 
MOV@R0,A 
INCRO 
INCR1 
DJNZR7JOP 
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This macro when called inserts the following code: 

MOV R7,#5 
MOV R0,#ADDR1 
MOVR1,#ADDR2 
TOP: MOVB,@R1 
MOVA,@R0 

MULAB 



,k, ^, ,« ^ i this is the return 

JNBOV,($ + 6) } va/ue o/MULT 



this is the return 
value of MULT _5 



LCALLOVFL_ERR 
MOV@R0,A 
INCRO 
INCR1 
DJNZR7JOP 

Macros with Parameters 

If the only thing the macro processor could do was simple string replacement, then it 
would not be very useful for most programming tasks. Each time we wanted to 
change even the simplest part of the macro's return value, we would have to redefine 
the macro. Parameters in macro calls allow more general purpose macros. 

Parameters leave blanks or holes in a macro body that you will fill in when you call 
the macro. This permits you to design a single macro that produces code for many 
typical programming operations. 

The term parameter refers to both the formal parameters that are specified when the 
macro is defined (the blanks), and the actual parameters or arguments that are 
specified when the macro is called (the fill-ins). 

The syntax for defining macros with parameters is very similar to the syntax for sim- 
ple macros. The call-pattern that we described earlier actually includes both the 
macro-name and an optional parameter-list. With this addition, the syntax for 
defining simple macros becomes: 

%* DEFIN E(macro-name \parameter-list]) {macro-body) 

The '%* DEFINE' is required for the same reasons described earlier. 

The macro-name must be a valid macro identifier . 

The parameter-list is a list of macro identifiers separated by macro delimiters. This 
comprises the formal parameters used in the macro. The macro identifier for each 
parameter in the list must be unique. 

Typically, the macro delimiters are parentheses and commas. When using these 
delimiters, you would enclose the parameter list in parentheses and separate each 
formal parameter with a comma. When you define a macro using parentheses and 
commas as delimiters, you must use those same delimiters, when you call that 
macro. The Advanced Concepts section completely describes the use of macro 
delimiters. For now we will use parentheses and commas when defining macros. 

The macro-body must be a balanced-text string. To indicate the locations of 
parameter replacement (the holes to be filled in by the actual parameters), place the 
parameter's name preceded by the metacharacter in the macro body. The 
parameters may be used any number of times and in any order within the macro 
body. If a user-defined macro has the same macro identifier name as one of the 
parameters to the macro, the macro may not be called within the macro body, 
because the parameter takes precedence. 
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The example below shows the definition of a macro with three dummy parameters— 
SOURCE, DESTINATION, and COUNT. The macro will produce code to copy 
any number of bytes from one part of memory to another. 

%*DEFINE(MOVE_BYTES(SOURCE,DESTINATION,COUNT))( 
MOVR7,#%COUNT 
MOVR1,#%SOURCE 
MOV R0,#%DESTINATION 
MOVA,@R1 
MOV@R0,A 
INCR1 
INCRO 

DJNZ R7,($-4) 
) 

To call the above macro, you must use the metacharacter followed by the macro's 
name similar to simple macros without parameters. However, a list of the actual 
parameters must follow. The actual parameters must be surrounded by parentheses, 
and separated from each other by commas, as specified in the macro definition. The 
actual parameters must be balanced-text and may optionally contain calls to other 
macros. A simple call to the macro defined above might be: 

%MOVE_BYTES(8,16,8) 

The above macro call produces the following code: 

MOV R7,#8 
MOVR1,#8 
MOVR0,#16 
MOVA,<g>R1 
MOV@R0,A 
INC R1 
INCRO 
DJNZ R7,($-4) 

The code above will copy the contents of register bank 2 to register bank 3. (We 
hope the user knows which bank is active when he executes this code.) 



LOCAL Symbols List 

The DJNZ instruction above uses offset addressing ($-4). If we chose to use a label 
for the jump destination, the macro could only be used once, since a second macro 
call would cause a conflict in label definitions. We could make the label a parameter 
and specify a different ASM51 symbol name each time we call the macro. The best 
way is to put the label in a LOCAL list. The LOCAL list construct allows you to use 
macro identifiers to specify assembly-time symbols. Each use of a LOCAL symbol 
in a macro guarantees that the symbol will be replaced by a unique assembly-time 
symbol. 

The macro processor increments a counter each time your program calls a macro 
that uses the LOCAL construct. The counter is incremented once for each symbol in 
the LOCAL list. Symbols in the LOCAL list, when used in the macro body, receive a 
two to five digit suffix that is the hexadecimal value of the counter. The first time 
you call a macro that uses the LOCAL construct, the suffix is '00' . 
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The syntax for the LOCAL construct in the DEFINE functions is shown below (This 
is the complete syntax for the built-in function DEFINE): 

%*DEF\NE(macro-name\parameter-list]) [LOCAL local-list] {macro-body) 

The local-list is a list of valid macro identifiers separated by spaces. The LOCAL 
construct in a macro has no affect on the syntax of a macro call. 

The example below shows the MOVE BYTES macro definition that uses a 

LOCAL list: 

%*DEFINE(MOVE_BYTES(SOURCE,DESTINATION,COUNT)) LOCAL LABEL 
(MOVR7,#%COUNT 
MOVR1,#%SOURCE 
MOV R0,#%DESTINATION 
%LABEL: MOVA,@R1 
MOV @R0,A 
INCR1 
INCRO 

DJNZ R7,%LABEL 
) 

The following macro call: 

%MOVE_BYTES(67,100,20) 

might produce this code (if this is the eleventh call to a macro using a LOCAL list): 

MOV R7,#27 
MOVR1,#67 
MOVR0,#100 
LABELOA: MOVA,@R1 
MOV@R0,A 
INC R1 
INC RO 
DJNZR7,LABEL0A 

NOTE 

Since macro identifiers follow the same rules as ASM51, you can use any 
macro identifier in a LOCAL list. However, if you use long identifier names 
(31 characters or more), the appended call number will be lost when the 
assembler truncates the excess characters. 



The Macro Processor's Built-in Functions 

The macro processor has several built-in or predefined macro functions. These 
built-in functions perform many useful operations that would be difficult or 
impossible to produce in a user-defined macro. An important difference between a 
user-defined macro and a built-in function is that user-defined macros may be 
redefined, while built-in functions can not be redefined. 

We have already seen one of these built-in functions, DEFINE. DEFINE creates 
user-defined macros. DEFINE does this by adding an entry in the macro processor's 
table of macro definitions. Each entry in the table includes the call-pattern for a 
macro, and its macro body. Entries for the built-in functions are present when the 
macro processor begins operation. 
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Other built-in functions perform numerical and logical expression evaluation, affect 
control flow of the macro processor, manipulate character strings, and perform 
console I/O. 

Comment, Escape, Bracket and METACHAR Built-in 
Functions 

Comment Function 

The Macro Processing Language can be very subtle, and the operation of macros 
written in a straightforward manner may not be immediately obvious. Therefore, it 
is often necessary to comment your macro definitions. Besides, it's just good 
programming practice. 

The macro processor's comment function has the following syntax: 

%'text' 

or 

% ' text end-of-line 

The comment function always evaluates to the null string. Two terminating 
characters are recognized, the apostrophe and the end-of-line (line feed character, 
ASCII OAH). The second form of the call allows you to spread macro definitions 
over several lines, while avoiding any unwanted end-of-lines in the return value. In 
either form of the comment function, the text or comment is not evaluated for 
macro calls. 

The example below shows a commented macro definition: 

%*DEFINE(MOVE_BYTES(SOURCE,DESTINATION,COUNT)) LOCAL LABEL 

( 

MOV R7,#%COUNT %' iteration argument %COUNT ' 

MOVR1,#%SOURCE %' source address argument %SOURCE 

MOV R0,#%DESTINATION %' destination address argument' 
%LABEL%' %LABEL is a local symbol that will be appended with a unique number 
: MOVA,@R1 

MOV@R0,A 

INCR1 

INC.RO 

DJNZR7,%LABEL %'This is the same local symbol and 
%' receives the same unique ID 

) 

Call to above macro: 

%MOVE_BYTES(27H,37H,5) 

Return value from above call: 

MOV R7,#5 

MOVR1,#27H MOVR0,#37H 

LABEL07: MOVA,@R1 
MOV@R0,A 
INCR1 
INCRO 
DJNZR7,LABEL07 
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Notice that the comments that were terminated with end-of-line removed the end-of- 
line character along with the rest of the comment. Because of this, the second line 
has two instuctions on it. That line will produce an error when assembled. However, 
when the comment was removed from the line containing the label % LABEL, the 
colon was raised to the same line making it a legal instruction. 

Note that the metacharacter is not recognized as a call to the macro processor when 
it appears in the comment function. 

Escape Function 

Occasionally, it is necessary to prevent the macro processor from processing text. 
There are two built-in functions that perform this operation: the escape function 
and the bracket function. 

The escape function interrupts the processor from its normal scanning of text. The 
syntax for this function is shown below: 

%n text-n-characters-long 

The metacharacter followed by a single decimal digit designates that the specified 
number of characters (maximum is 9) shall not be evaluated. The escape function is 
useful for inserting a metacharacter as text, adding a comma as part of an argument, 
or placing a single parenthesis in a character string that requires balanced 
parentheses. 

Several examples of the escape function are shown below: 

Before Macro Expansion After Macro Expansion 

; COMPUTE 10%1% OF SUM - ; COMPUTE 10% OF SUM 

%MACCALL(JANU ARY 23%1 , 1980, - JANUARY 23, 1980 

MARCH 15%1, 1980, - MARCH 15, 1980 

APRIL 9%1, 1980) — APRIL 9, 1980 

actual parameters 

%MACCALL(1%1) ADD INPUTS, ■* 1) ADD INPUTS 

2%1) DIVIDE BY INPUT COUNT, - 2) DIVIDE BY INPUT COUNT 
3%1) GET INPUTS) - 3) GET INPUTS 

actual parameters 



Bracket Function 

The other built-in function that inhibits the macro processor from expanding text is 
the bracket function. The syntax of the bracket function is shown below: 

%(bafanced'text) 

The bracket function inhibits all macro processor expansion of the text contained 
within the parentheses. However, the escape function, the comment function, and 
parameter substitution are still recognized. Since there is no restriction for the length 
of the text within the bracket function, it is usually easier to use than the escape 
function. However, since balanced text is required and the metacharacter is inter- 
preted, often this is not sufficient, and the escape function must be used. 

Consider the following example of the bracket function. 

%*DEFINE(DW(LIST,LBL)) ( 
%LBL:DW%LIST 

) 
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The macro above will add DW statements to the source file. It uses two parameters: 
one for the statement label and one for the DW expression list. Without the bracket 
function we would not be able to use more than one expression in the list, since the 
first comma would be interpreted as the delimiter separating the macro parameters. 
Bracket function permits more than one expression in the LIST argument: 

%DW(%(198H,3DBH,163BH),PHONE) - PHONE: DW198H,3DBH,163BH 

In the example above, the bracket function prevents the character string '198H, 
3DBH, 163BH' from being evaluated as separate parameters. 



METACH AR Function 

The built-in function METACHAR allows you to redefine the metacharacter (%). 
Its syntax is shown below: 

%MET ACH AK(balanced-text) 

The balanced-text argument may be any number of characters long. However, only 
the first character in the string is taken to be the new metacharacter. Extreme cau- 
tion should be taken when using METACHAR, since it can have catastrophic 
effects. Consider the example below: 

%METACHAR( & ) 

In this example, METACHAR defines the space character to be the new meta- 
character, since it is the first character in the balanced-text string! 



Numbers and Expressions in MPL 

Many of the built-in functions recognize and evaluate numerical expressions in their 
arguments. The macros use the same rules for representing numbers as ASM51 : 

• Numbers may be represented in base 2 (B suffix), base 8 (O or Q suffix), base 10 
(D suffix or no suffix), and base 16 (H suffix). 

• Internal representation of numbers is 16 bits (00H to OFFFFH). 

• All ASM51 operators are recognized, except the symbolic forms of the 
relational operators (i.e., <, >, =, <>, >=, <=). The operators recognized by 
the macro processor and their precedence is shown in the list below: 

1. 

2. HIGH, LOW 

3. *,/,MOD,SHL,SHR 

4. + ,- unary and binary forms 

5. EQ, NE, LE, LT, GE, GT 

6. NOT 

7. AND 

8. OR,XOR 

Although assembly-time and macro-time expressions use the same operators, the 
macro processor cannot access the assembler's symbol table. The values of labels 
and SET and EQU symbols are not known during macro-time expression evalua- 
tion. Any attempt to use assembly-time symbols in a macro-time expression 
generates an error. However, you can define macro-time symbols with the pre- 
defined macro SET. 
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SET Macro 

The SET predefined macro permits you to define macro-time symbols to values. 
SET takes two arguments: a valid MPL identifier, and a macro-time numeric 
expression. 

SET has the following syntax: 

%SET "(macro-id ', expression ) 

SET assigns the value of the numeric expression to the identifier, macro-id. 
macro-id must follow the same syntax conventions used for macro identifiers. 

• The first character must be a letter of the alphabet or a question mark or an 
underscore. 

• The remaining characters may be digits, letters, question marks, or underscores. 

• Only the first 31 characters are recognized as the identifier name. Upper and 
lower case letters are not distinguished. 

The SET macro call affects the macro-time symbol table only; when it is 
encountered in the source file, the macro processor replaces it with the null string. 
Symbols defined by SET can be redefined by a second SET call, or defined as a 
macro by a DEFINE call. 

The following examples show several ways to use SET: 

Before Macro Expansion After Macro Expansion 

%SET(COUNT,0) - null string 

%SET(OFFSET,16) - null string 

MOV R1 ,#%COUNT + %OFFSET - MOV R1 ,#00H + 10H 

MOV R4,#%COUNT - MOV R4,#00H 

The SET symbol may be used in the expression that defines its own value. 

%SET(COUNT,%COUNT + %OFFSET) - null string 

%SET(OFFSET,%OFFSET * 2) - null string 

MOV R2,#%COUNT + %OFFSET -* MOV R2,#10H + 20H 

MOV R5,#%COUNT - MOVR5,#10H 

In the example above, macro-time symbols are used rather than assembly-time 
symbols because their value is shown wherever they are used. With assembly-time 
symbols, you must look in the symbol table for its value. 

SET is a predefined macro, not a built-in function; as such it may be redefined, but 
we don't advise it. 



EVAL Function 

The built-in function EVAL accepts an expression as its argument and returns the 
expression' s value in hexadecimal . The syntax for EVAL is : 

% EV M{expression ) 

The expression argument must be a legal macro-time expression. 
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The return-value from EVAL follows ASM51's rules for representing hexadecimal 
numbers (it has an 'H' suffix and when the leading digit is *A\ *B\ 'C\ 'D\ *E\ or 
'F\ it is preceded by 0). EVAL always returns at least 3 characters even when the 
argument evaluates to a single digit. The following examples show the return-value 
from EVAL: 

Before Macro Expansion After Macro Expansion 

MOV A,#%EVAL(1 +1); move two to A. -* MOV A,#02H; move two to A. 

COUNT EQU %EVAL(33H + 15H + 0F00H) -* COUNT EQU 0F48H 

ADD A,#%EVAL(10H-((13 + 6)*2) + 7) - ADD A,#0FF0BH 

%SET(NUM1,44) 

%SET(NUM2,25H) 

ANLA,#%EVAL(%NUM1LE%NUM2) - ANLA,#00H 



Logical Expressions and String Comparisons in MPL 

Several built-in functions return a logical value when they are called. Like relational 
operators that compare numbers and return true or false (OFFFFH or 00H), these 
built-in functions compare character strings. If the function evaluates to TRUE,' 
then it returns the character string 'OFFFFH' (this represents a 16-bit value contain- 
ing all ones). If the function evaluates to 'FALSE,' then it returns 4 00H' (this ( 
represents a 1 6-bit value containing all zeros) . 

The built-in functions that return a logical value compare two balanced-text string 
arguments and return a logical value based on that comparison. The list of string 
comparison functions below shows the syntax and describes the type of comparison 
made for each. Both arguments to these functions may contain macro calls (the calls 
are expanded before the comparison is made). 

%EQ$(arg1 ,arg2) True if both arguments are identical 

%HES{arg1 ,arg2) True if arguments are different in any way 

%LTS(arg1 ,arg2) True if first argument has a lower value than second argument 

%LES(arg1 ,arg2) True if first argument has a lower value than second argument or if 

both arguments are identical 

%GTS(argt ,arg2) True if first argument has a higher value than second argument 

%GES{arg1 ,arg2) True if first argument has a higher value than second argument, or 

if both arguments are identical 

Before these functions perform a comparison, both arguments are completely 

expanded. Then the ASCII value of the first character in the first string is compared 

to the ASCII value of the first character in the second string. If they differ, then the 

string with the higher ASCII value is greater. If the first characters are the same, 4 

then the process continues with the second character in each string, and so on. Two 

strings of equal length that contain the same characters in the same order are equal. 



5-12 



MCS-5 1 Macro Processing Language 

The examples below show several calls to these macros: 

Before Macro Expansion After Macro Expansion 

%EQS(ABC, ABC) — 00H the space after the comma is part 

false of the second argument 

%LTS(CBA,cba) -* OFFFFH the lower-case characters have a 

true higher ASCII value than upper- 

case 

%GTS(11H,16D) -* 00H these macros compare strings not 

false numerical values ASCII '6' is 
greater ASCII '1' 

%GES(ABCDEFG , ABCDEFG ) - 00H the space at the end of the second 

false argument makes the second 
argument greater than the first 

As with any other macro, the arguments to the string comparison macros can be 
other macros. 

%*DEFINE(DOG)(CAT) 
%*DEFINE(MOUSE) (%DOG) 
%EQS(%DOG,%MOUSE) - OFFFFH 

true 



Control Flow Functions 

Some built-in functions accept logical expressions in their arguments. Logical 
expressions follow the same rules as numeric expressions. The difference is in how 
the macro interprets the 16-bit value that the expression represents. Once the expres- 
sion has been evaluated to a 16-bit value, MPL uses only the low-order bit to deter- 
mine whether the expression is TRUE or FALSE. If the low-order bit is a one (the 
16-bit numeric value is odd), the expression is TRUE. If the low-order bit is a zero 
(the 16-bit value is even), the expression is FALSE. 

Typically, you will use either the relational operators (EQ, NE, LE, LT, GT, or GE) 
or the string comparison functions (EQS, NES, LES, LTS, GTS, or GES) to specify 
a logical value. Since these operators and functions always evaluate io OFFFFH (all 
ones) or 00H (all zeros), you needn't worry about the single bit test. But remember, 
all numeric expressions are valid, and regardless of the value of the other 15 bits, 
only the least significant bit counts. 



IF Function 

The IF built-in function evaluates a logical expression, and based on that expression, 
expands or witholds its text arguments. The syntax for the IF macro is shown below: 

• %\¥(expression)lHEH(balanced-text1) [ELSE (balanced-text2))?\ 

IF first evaluates the expression , if the low order bit is one, then balanced-text 1 is 
expanded; if the low order bit is zero and the optional ELSE clause is included in the 
call, then balanced-text! 'is expanded. If the low order bit is zero and the ELSE 
clause is not included, the IF call returns the null string. FI must be included to ter- 
minate the call. 
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IF calls can be nested; when they are, the ELSE clause refers to the most recent IF 
call that is still open (not terminated by FI). FI terminates the most recent IF call 
that is still open. 

Several examples of IF calls are shown below: 

This is the simple form of the IF call with an ELSE clause. 

%IF (%EQS(ADD,%OPERATION)) THEN (ADD A,R1) ELSE (SUBBA,R1) FI 

This is an example of several nested IF calls. 

open first IF %IF (%EQS(ADD,%OPERATION)) THEN (ADD A,R1 

open second IF )ELSE (%IF (%EQS(SUBTRACT,%OPERATION» THEN (SUBB A, R1 

)ELSE(MOVB,R1 
open third IF %IF (%EQS(MULTIPLY,%OPERATION)) THEN (MUL AB 

)ELSE(DIVAB 
close third IF )FI 

close second IF ) FI 

close first IF )FI 



WHILE Function 

The IF macro is useful for implementing one kind of conditional assembly- 
including or excluding lines of code in the source file. However, in many cases this is 
not enough. Often you may wish to perform macro operations until a certain condi- 
tion is met. The built-in function WHILE provides this facility. 

The syntax of the WHILE macro is shown below: 

% WH I LE (expression ) (balanced-text) 

WHILE first evaluates the expression. If the least significant bit is one, then the 
balanced-text is expanded; otherwise, it is not. Once the balanced-text has been 
expanded, the logical argument is retested and if the least significant bit is still one, 
then the balanced-text is again expanded/This continues until the logical argument 
proves false (the least significant bit is 0). 

Since the macro continues processing until expression is false, the balanced-text 
should modify the expression , or else WHILE may never terminate. 

A call to the built-in function EXIT will always terminate a WHILE macro. EXIT is 
described below. 

The following examples show two common uses of the WHILE macro: ' 

%SET(COUNTER,5) 
%WHILE(%COUNTER GT 0) 
(RRA 

%SET(COUNTER, %COUNTER-1) 
) 

%WHILE(%LOC_COUNTER LT OFFFFH) ( NOP 

%SET(LOC_COUNTER, %LOC_COUNTER + 1) ) 

These examples use the SET macro and a macro-time symbol to count the iterations * 

of the WHILE macro. 
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REPEAT Function 

MPL offers another built-in function that will perform the counting automatically. 
The built-in function REPEAT expands its balanced-text a specified number of 
times. The general form of the call to REPEAT is shown below: 

% REPEAT (expression ) (balanced-text) 

Unlike the IF and WHILE macros, REPEAT uses the expression for a numerical 
value that specifies the number of times the balanced-text will be expanded. The 
expression is evaluated once when the macro is first called, then the specified 
number of iterations is performed. 

The examples below will perform the same text insertion as the WHILE examples 
above. 

%REPEAT (5) (RR A 

) 

%REPEAT (OFFFFH - %LOC_COUNTER) (NOP 

) 



EXIT Function 

The EXIT built-in function terminates expansion of the most recently called 
REPEAT, WHILE or user-defined macro. It is most commonly used to avoid 
infinite loops (e.g., a WHILE expression that never becomes false, or a recursive 
user-defined macro that never terminates). It allows several exit points in the same 
macro. 

The syntax for EXIT is: 

%EXIT 

Several examples of how you might use the EXIT macro follow: 

This use of EXIT terminates a recursive macro when an odd number of bytes are 
being added. 

%*DEFINE (MEM__ADD_MEM (SOURCE,DESTIN, BYTES)) 
( 

MOVA,%SOURCE 

ADDCA,%DESTIN 

MOV%DESTIN,A 

IF (%BYTES EQ 1) THEN (%EXIT) Fl 

MOV A,%SOURCE + 1 

ADDC A, %DESTIN + 1 

MOV %DESTIN + 1 , A 

IF(%BYTESGT2)THEN( 

%MEM__ADD__MEM(%SOURCE + 2,%DESTIN + 2,%BYTES -2)) Fl 
) 

This EXIT is a simple jump out of a recursive loop. 

%*DEFINE(UNTIL ( CONDITION, BODY)) 

( %BODY 
k %IF (%CONDITION) THEN (%EXIT) 

^ ELSE ( %UNTIL(%CONDITION,%BODY)) Fl 

) 
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String Manipulation Built-in Functions 

The purpose of the Macro Processor is to manipulate character strings. Therefore, 
there are several built-in functions that perform common character string manipula- 
tion functions. 



LEN Function 

The built-in function LEN takes a character string argument and returns the length 
of the character string in hexadecimal (the same format as EVAL). The character 
string argument to LEN is limited to 256 characters. 

The syntax of the LEN macro call is shown below: 

%VEH(balanced-text) 

Several examples of calls to LEN and the hexadecimal numbers returned are shown 
below: 



Btfore Macro Expansion After Macro Expansion 

%LEN(ABCDEFGHIJKLMNOPQRSTUVWXYZ) - 1AH 

%LEN(A,B,C) -* 05H commas are counted 

%LEN() - 00H 

%*DEFINE(CHEESE)(MOUSE) 
%*DEFINE(DOG)(CAT) 

%LEN(%DOG %CHEESE) - 09H 

A the space after G is counted 
as part of the length 



SUBSTR Function 

The built-in function SUBSTR returns a substring of its text argument. The macro 
takes three arguments: a character string to be divided and two numeric arguments. 
The syntax of the macro call to SUBSTR is shown below: 

%S U BSTR(balanced-text , expression 1 ,expression2) 

balanced-text is described above. It may contain macro calls. 

expression 1 specifies the starting character of the substring. 

expression! specifies the number of characters to be included in the substring. 

If expressionl is zero or greater than the length of the argument string, then 
SUBSTR returns the null string. 

If expression! is zero, then SUBSTR returns the null string. If expression! is greater 
than the remaining length of the string, then all characters from the start character 
to the end of the string are included. 
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The examples below show several calls to SUBSTR and the value returned: 
Before Macro Expansion After Macro Expansion 

%SUBSTR(ABCDEFG,8,1) - null 

%SUBSTR(ABCDEFG,3,0) - null 

%SUBSTR(ABCDEFG,5,1) - E 

%SUBSTR(ABCDEFG,5,100) - EFG 

%SUBSTR(123(56)890,4,4) - (56) 

MATCH Function 

The built-in function MATCH searches a character string for a delimiter character, 
and assigns the substrings on either side of the delimiter to the identifiers. The syn- 
tax of the MATCH call is shown below: 

%hAJKTCH{identifier1 delimiter identified) {balanced-text) 

identifier 1 and identified are valid MPL identifiers. 

delimiter is the first character to follow identifierl . Typically, a space or comma is 
used, but any character that is not a macro identifier character may be used. You 
can find a more complete description of delimiters in the Advanced Concepts section 
at the end of the chapter. 

balanced-text is as described earlier in the chapter. It may contain macro calls. 

MATCH searches the balanced-text string for the specified delimiter. When the 
delimiter character is found, then all characters to the left of it are assigned to iden- 
tifierl and all characters to the right are assigned to identifier!. If the delimiter is 
not found, the entire balanced-text string is assigned to identifierl and the null 
string is assigned to identifier!. 

The following example shows a typical use of the MATCH macro. 

%MATCH(NEXT,LIST) (10H, 20H, 30H) 
%WHILE(%LEN(%NEXT) NE 0) ( 

MOVA,%NEXT 

ADDA,#22H 

MOV %NEXT,A 

%MATCH(NEXT,LIST)(%LIST) 
) 

Produces the following code: 



first I 


MOVA,10H 


iteration > 


ADD A,#22H 


of WHILE ) 


MOV10H,A 


second \ 


MOV A, 20H 


iteration > 


ADD A,#22H 


of WHILE ) 


MOV 20H,A 


third \ 


MOV A, 30H 


iteration \ 


ADD A,#22H 


of WHILE I 


MOV 30H,A 
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Console I/O Built-in Functions 

There are two built-in functions that perform console I/O when expanded: IN and 
OUT. Their names describe the function each performs. IN outputs a greater than 
character '>' as a prompt to the console, and returns the next line typed at the con- 
sole. OUT outputs a string to the console; a call to OUT is replaced by the null 
string. The syntax of both macros is shown below: 

%IN 

%0\JT(ba/anced-text) 

Several examples of how these macros can be used are shown below: 

%OUT(ENTER NUMBER OF PROCESSORS IN SYSTEM?) 
%SET(PROC_COUNT,%IN) 
%OUT(ENTER THIS PROCESSOR'S ADDRESS?) 
ADDRESS EQU %IN 

%OUT(ENTER BAUD RATE?) 
%SET(BAUD,%IN) 

The following lines would be displayed at the console: 

ENTER NUMBER OF PROCESSORS IN SYSTEM?>t/ser response 
ENTER THIS PROCESSOR'S ADDRESS?><yser response 
ENTER BAUD RATE?>user response 



Advanced M PL Concepts 

For most programming problems, the Macro Processing Language syntax described 
above is sufficient. However, in some cases a more complete description of the 
macro processor's function is necessary. 

However, it is impossible to describe all of the subtleties of the macro processor in a 
single chapter. With the rules described in this section, you should be able to discern, 
with a few simple tests, the answer to any specific question about MPL. 



Macro Delimiters 

When we discussed the syntax for defining macros, we showed one type of delimiter. 
The parameter-list was surrounded by parentheses, and parameters were separated 
by commas. Because we used these delimiters to define a macro, a call to the macro 
required that these same delimiters be used. When we discussed the MATCH func- 
tion, we mentioned that a space could be used as a delimiter. In fact the macro pro- 
cessor permits almost any character or group of characters to be used as a delimiter. 

Regardless of the type of delimiter used to define a macro, once it has been defined, 
only the delimiters used in the definition can be used in the macro call. Macros 
defined with parentheses and commas require parentheses and commas in the macro 
call. Macros defined with spaces (or any other delimiter), require that delimiter 
when called. 

Macro delimiters can be divided into three classes: implied blank delimiters, iden- 
tifier (or id) delimiters, and literal delimiters. 
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Implied Blank Delimiters 

Implied blank delimiters are the easiest to use and contribute the most readability 
and flexibility to macro calls and definitions. An implied blank delimiter is one or 
more spaces, tabs or new lines (a carriage-return/linefeed pair) in any order. To 
define a macro that uses the implied blank delimiter, simply place one or more 
spaces, tabs, or new lines surrounding the parameter list and separating the formal 
parameters. 

When you call the macro defined with the implied blank delimiter, each delimiter 
will match a series of spaces, tabs, or new lines. Each parameter in the call begins 
with the first non-blank character, and ends when a blank character is found. 

An example of a macro defined using implied blank delimiters is: 

%*DEFINE(SENTENCE SUBJECT VERB OBJECT ) (THE %SUBJECT %VERB %OBJECT.) 
All of the following calls are valid for the above definition: 



Before Macro Expansion 




After Macro Expansion 


%SENTENCE TIME IS RIPE 




- THE TIME IS RIPE 


%SENTENCE CATS 






EAT 






FISH 




- THE CATS EAT FISH 


%SENTENCE 






PEOPLE 






LIKE 


FREEDOM 


- THE PEOPLE LIKE FREE! 



Identifier Delimiters 



Identifier (Id) delimiters are legal macro identifiers designated as delimiters. To 
define a macro that uses an id delimiter in its call pattern, you must prefix the 
delimiter with the commercial at symbol (@). You must separate the id delimiter 
from the macro identifiers (formal parameters or macro name) by a blank character. 

When calling a macro defined with id delimiters, an implied blank delimiter is 
required to precede the id delimiter, but none is required to follow the id delimiter. 

An example of a macro defined with id delimiters is: 



%*DEFINE(ADDP1 @TO P2 @AND P3)( 
MOVA'%P1 
ADD A,%P2 
MOV %P2,A 
MOV A,%P1 
ADD A,%P3 
MOV %P3,A 
) 
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The following call (note that no blank character follows the id delimiters TO and 
AND): 

%ADD ATOM TOMOLECULE ANDCRYSTAL 

returns this code when expanded: 

MOV A.ATOM 
ADDA,MOLECULE 
MOV MOLECULE, A 
MOVA.ATOM 
ADDA.CRYSTAL 
MOV CRYSTALS 



Literal Delimiters 

The delimiters used when we documented user-defined macros (parentheses and 
commas) were literal delimiters. A literal delimiter can be any character except the 
metacharacter. 

When you define a macro using a literal delimiter, you must use exactly that 
delimiter when you call the macro. If you do not include the specified delimiter 
character as it appears in the definition, it will generate a macro error. 

When defining a macro, you must literalize the delimiter string, if the delimiter you 
wish to use meets any of the following conditions: 

• uses more than one character, 

• uses a macro identifier character (A-Z, 0-9, , or ?), 

• uses a commercial at (@), 

• uses a space, tab, carriage-return, or linefeed, 

You can use the escape function (%/?) or the bracket function (%()) to literalize the 
delimiter string. Several examples of definitions and calls using a variety of literal 
delimiters are shown below: 

This is the simple form shown earlier: 

Before Macro Expansion After Macro Expansion 

%*DEFINE(MAC(A,B))(%A %B) - null string 

%MAC(4,5) - 4 5 

In the following example brackets are used instead of parentheses. The commercial 
at symbol separates parameters: 

%*DEFINE(MOV[A%(@)B]) (MOV %A,%B) - null string 

%MOV[P0@P1] - MOVP0,P1 

In the next two examples, delimiters that could be id delimiters have been defined as 
literal delimiter (the differences are noted): 

%*DEFINE(ADD(A%(AND)B))(ADD%A,%B) - null string 
%ADD#27H) ■* ADDA,#27H 

Spaces around AND are considered as part of the argument string. 
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To illustrate the differences between between id delimiters and literal delimiters, 
consider the following macro definition and call. (A similar macro definition is dis- 
cussed with id delimiters): 

%*DEFINE(ADD P1(TO)P2 %AND) P3 ) ( 
MOVA,%P1 
ADDA,%P2 
MOV%P2,A 
MOVA,%P1 
ADDA,%P3 
MOV %P3,A 
) 

The following call: 

%ADD ATOM TOMOLECULE ANDCRYSTAL 

returns this code when expanded (the TO in ATOM is recognized as the delimiter): 

MOVA,A 

ADD A, M TOMOLECULE 

MOVMTOMOLECULE,A 

MOV A, A 

ADD A,CRYSTAL 

MOV CRYSTALS 



Literal vs. Normal Mode 

In normal mode, the macro processor scans text looking for the metacharacter. 
When it finds one, it begins expanding the macro call. Parameters are substituted 
and macro calls are expanded. This is the usual operation of the macro processor, 
but sometimes it is necessary to modify this mode of operation. The most common 
use of the literal mode is to prevent macro expansion. The literal character in 
DEFINE prevents the expansion of macros in the macro-body until you call the 
macro. 

When you place the literal character in a DEFINE call, the macro processor shifts to 
literal mode while expanding the call. The effect is similar to surrounding the entire 
call with the bracket function. Parameters to the literalized call are expanded, the 
escape, comment, and bracket functions are also expanded, but no further process- 
ing is performed. If there are any calls to other macros, they are not expanded. 

If there are no parameters in the macro being defined, the DEFINE built-in function 
can be called without the literal character. If the macro uses parameters, the macro 
processor will attempt to evaluate the formal parameters in the macro-body as 
parameter less macro calls. 

The following example illustrates the difference between defining a macro in literal 
mode and normal mode: 

%SET(TOM,1) 

%*DEFINE(AB) (%EVAL(%TOM)) 

%DEFINE(CD) (%EVAL(%TOM)) 
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When AB and CD are defined, TOM is equal to 1. The macro body of AB has not 
been evaluated due to the literal character, but the macro body of CD has been com- 
pletely evaluated, since the literal character is not used in the definition. Changing 
the value of TOM has no effect on CD, but it changes the return value of AB, as 
illustrated below: 

Before Macro Expansion After Macro Expansion 

%SET(TOM,2) 

%AB - 02H 

%CD — 01 H 

The macros themselves can be called with the literal character. The return value 
then is the unexpanded body: 

%*CD -> 01 H 

%*AB - %EVAL(%TOM) 

The literalized calls to AB and CD show that CD evaluates to 01 H, while AB con- 
tains a macro call to EVAL with %TOM as its parameter. 



Algorithm for Evaluating Macro Calls 

The Algorithm the macro processor uses for evaluating the source file can be seen in 
6 steps: 

1 . Scan source until metacharacter is found . 

2. Isolate call pattern. See note below. 

3. If macro has parameters, expand each parameter from left to right (initiate step 
one on actual parameter), before expanding next parameter. 

4. Substitute actual parameters for formal parameters in macro body. 

5 . If literal character is not used, initiate step one on macro body. 

6. Insert result into output stream. 

NOTE 

When isolating the call pattern, the macro processor is actually scann- 
ing input for the specified delimiter. All text found between delimiters 
is considered the actual parameter. For this reason Id delimiters need 
not be terminated by spaces in a call, and the 'TO' in 'ATOM' satisfied 
the literal delimiter, when the 'M TOMOLECULE ' became the second 
parameter. 

The terms 'input stream' and 'output stream* are used, because the return value of 
one macro may be a parameter to another. On the first iteration, the input stream is 
the source file. On the final iteration, the output stream is the temporary workfile 
that passes to the assembler. 

The examples below illustrate the macro processor's evaluation algorithm: 

%SET(TOM,3) 
%*DEFINE(STEVE)(%SET(TOM,%TOM-1)%TOM) 

%*DEFINE(ADAM(A,B))( 

DB %A, %B, %A, %B, %A, %B 

) 
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Here is a call ADAM in the normal mode with TOM as the first actual parameter 
and STEVE as the second actual parameter. The first parameter is completely 
expanded before the second parameter is expanded. After the call to ADAM has 
been completely expanded, TOM will have the value 02H. 

Before Macro Expansion After Macro Expansion 

%ADAM(%TOM,%STEVE) - DB 03H, 02H, 03H, 02H, 03H, 02H 

Now reverse the order of the two actual parameters. In this call to ADAM, STEVE 
is expanded first (and TOM is decremented) before the second parameter is 
evaluated. Both parameters have the same value. 

%SET(TOM,3) 

%ADAM(%STEVE,%TOM) - DB 02H, 02H, 02H, 02H, 02H, 02H 

Now we will literalize the call to STEVE when it appears in the first actual 
parameter. This prevents STEVE from being expanded until it is inserted in the 
macro body, then it is expanded for each replacement of the formal parameters. 
Tom is evaluated before the substitution in the macro body. 

%SET(TOM,3) 

%ADAM(%*STEVE,%TOM) - DB 02H, 03H, 01H, 03H, 00H, 03H 
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CHAPTER 6 

ASSEMBLER OPERATION 

AND CONTROLS 



This chapter describes how to invoke the MCS-51 Macro Assembler from your 
Intellec System running under the ISIS operating system. The assembler controls are 
also fully described. 



How to Invoke the MCS-51 Macro Assembler 

The command to invoke the assembler is shown below: 

[:Fn:]ASM51 [:F n:\sourcefile\.extension\ [controls] 

You must specify the filename of the assembler ([:Fji:]ASM51) and the filename of 
your source code ([:¥n :]sourcefile[.e*tei2s;ojj]. The controls are optional. 

ASM51 normally produces two output files. One contains a formatted listing of 
your source code. Unless you specify a particular filename with the PRINT control, 
it will have the same name as your source file, but with the extension 'LST'. The 
format for the listing file and how to change that format will be described in Chapter 
7. The other file produced by the assembler is the object file. Unless you specify a 
particular filename with the OBJECT control, it will also have the same name as 
your source file, but its extension will be 'OBJ'. 

For example note the assembler invocation below. 

-ASM51 PROG.SRC 

If there were no controls in PROG.SRC that changed the default output files, 
ASM51 would produce two files. The listing file will be :F0:PROG.LST, and the 
object file will be :F0:PROG.OBJ. 

In addition to the output files, ASM51 uses intermediate files named 
ASM51x.TMP. They will be deleted before the assembler completes execution. 
Normally these files will be created on the same drive as your source program; 
however, you can specify the drives to be used with the WORKF1LES control. 

Any control (except INCLUDE) can be used in the invocation line. 

You can continue the invocation line on one or more additional lines by typing an 
ampersand (&) before you type a carriage return. ASM51 prompts for the remainder 
of the invocation line by issuing a double asterisk followed by a blank (** ). Since 
everything following an ampersand on a line is echoed, but ignored, you can com- 
ment the invocation line; these comments are echoed in the listing heading. (See 
Chapter 7 for an example.) Note the example below: 

-ASM51 PROG.SRC D ATE(9-30-81 ) & Comment 

** TITLE(COMPLETE PROJECT REV. 3.0) & Comment 
**GEN 

Errors detected in the invocation line are considered fatal and the assembler aborts 
without processing the source program. 
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Assembler Controls 

Assemble controls may be entered in the invocation line as described above or on a 
control line in your source code. The general format for control lines is shown 
below: 

$ Control List [; Comment] 

The dollar sign ($) must be the first character on the line. The control list is zero or 
more controls separated by one or more spaces or tabs. The comment is optional. 

ASM51 has two classes of controls: primary and general. The primary controls are 
set in the invocation line or the primary control lines and remain in effect 
throughout the assembly. For this reason, primary controls may only be used in the 
invocation line or in a control line at the beginning of the program. Only other 
control lines (that do not contain the INCLUDE control) may precede a line con- 
taining a primary control. The INCLUDE control terminates processing of primary 
controls. 

If a Primary Control is specified in the invocation line and in the primary control 
lines, the first time counts. This enables the programmer to override primary con- 
trols via the invocation line. 

The general controls are used to control the immediate action of the assembler. 
Typically their status is set and modified during an assembly. Control lines contain- 
ing only general controls may be placed anywhere in your source code. 

Table 6-1 lists all of the controls, their abbreviations, their default values, and a 
brief description of each . 



Table 6-1. Assembler Controls 



Name 


Primary/ 
General 


Default 


Abbrev. 


Meaning 


DATE(ctete) 


P 


DATE( ) 


DA 


Places string in header (max 
9 characters) 


DEBUG 


P 


NODEBUG 


DB 


Outputs debug symbol 
Information to object file 


NODEBUG 


P 


NODB 


Symbol information not 
placed in object file 


EJECT 


G 


Not Applicable 


EJ 


Continue listing on next 
page 


ERRORPRINT[(F/LE)] 


P 


NOERRORPRINT 


EP 


Designates a file to receive 
error messages in addition 
to the listing file defaults to 
;co: 


NOERRORPRINT 


P 


NOEP 


Designates that error mes- 
sages will be printed in 
listing file only 


GEN 


G 


GENONLY 


GE 
GO 


Generates a full listing of the 
macro expansion process 
including macro calls in the 
listing file 


GENONLY 


G 


List only the fully expanded 
source as if all lines gen- 
erated by a macro call were 
already in source file 
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Table 6-1. 


Assembler Controls (Cont'd.) 


Name 


Primary/ 
General 


Default 


Abbrev. 


Meaning 


NOGEN 


G 


GENONLY 


NOGE 


List only the original source 
text in listing file 


INCLUDE(F/Z.£) 


G 


Not Applicable 


IC 


Designates a file to be 
included as part of the 
program 


LIST 


G 


LIST 


LI 


Print subsequent lines of 
source in listing file 


NOLIST 


G 


NOLI 


Do not print subsequent 
lines of source in listing file 


MACRO [(mempercent)] 


P 


MACRO(50) 


MR 


Evaluate and expand all 
macro calls. Allocate 
percentage of free memory 
for macro processing 


NOMACRO 


P 


NOMR 


Do not evaluate macro calls 


OBJECT[(F/Z.£)] 


P 


OBJECT(soi/rce .OBJ) 


OJ 


Designate file to receive 
object code 


NOOBJECT 


P 


NOOJ 


Designates that no object 
file will be created 


PAGING 


P 


PAGING 


PI 


Designates that listing will 
be broken into pages and 
each will have a header 


NOPAGING 


P 


NOPI 


Designates that listing will 
contain no page breaks 


PAGELENGTH(n) 


P 


PAGELENGTH(60) 


PL 


Sets maximum number of 
lines in each page of listing 
file (maximum = 65,535) 
(minimum = 10) 


PAGEWIDTH(n) 


P 


PAGEWIDTH(120) 


PW 


Sets maximum number of 
characters in each line of 
listing file (maximum = 132; 
minimum = 80) 


PR\HJ[{FILE)) 


P 


PRINT(scwrce. LST) 


PR 


Designates file to receive 
source listing 


NOPRINT 


P 


NOPR 


Designates that no listing 
file will be created 


SAVE 


G 


Not Applicable 


SA 


Stores current control set- 
ting for LIST and GEN 


RESTORE 


G 


RS 


Restores control setting 
from SAVE stack 


REGISTERBANK(rf>,...) 
rb = 0,1,2,3 


P 


REGISTERBANK(O) 


RB 


Indicates one or more banks 
used in program module 


NOREGISTERBANK 


P 


NORB 


Indicates that no banks are 
used. 


SYMBOLS 


P 


SYMBOLS 


SB 


Creates a formatted table of 
all symbols used in program 


NOSYMBOLS 


P 


NOSB 


No symbol table created 


TITLE(sfr/nfir) 


G 


TITLEO 


TT 


Places a string in all sub- 
sequent page headers 
(maximum 60 characters) 


WORKFILES(:Fn:[,:Fm:]) 


P 


same drive as 
source file 


WF 


Designates alternate drives 
for temporary workfiles 


XREF 


P 


NOXREF 


XR 


Creates a cross reference 
listing of all symbols used in 
program 


NOXREF 


P 


NOXR 


No cross reference list 
created 
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Control Switch Name: 



DATE 



Abbreviation: DA 

Arguments: (string) (Nine characters maximum) 

Control Class: Primary 



Default: 
Definition: 



Example: 



(Spaces inserted) 

The assembler takes the character string specified as the argument 
and inserts it in the header. If you specify less than 9 characters, 
then it will be padded with blanks. If more than 9 characters are 
specified, then the character string will be truncated to the first 
nine characters. DATE is overridden by NOPRINT. 

NOTE 

Any parentheses in the DATE string must be balanced. 



$TITLE(PROJECT S.W.B. REV. 27) 
(Header will look like this) 
MCS-51 MACROASSEMBLER PROJECT S.W.B. REV. 27 



DATE(8-18-81) 



8-18-81 PAGE 1 



Control Switch Name: DEBUG/NODEBUG 

Abbreviation: DB/NODB 

Arguments: None 

Control Class: Primary 

Default: NODEBUG 

Definition: Indicates whether debug symbol information shall be output to 

object file. If DEBUG is in effect the debug information will be 
output. This control must be used if you wish to run the program 
withanICE-51. 

DEBUG is overridden by NOOBJECT. 

Example: $DEBUG 
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Control Switch Name: 



EJECT 



Abbreviation: EJ 

Arguments: None 

Control Class: General 

Default: (New page started when PAGELENGTH reached) 

Definition: Inserts formfeed into listing file, after the control line containing 

the EJECT, and generates a header at top of the next page. The 
control is ignored if NOPAGING, NOPRINT, or NOLIST is in 

effect. 

Example: $EJECT 



Control Switch Name: ERRORPRINT/NOERRORPRINT 



Abbreviation: 
Arguments: 

Control Class: 

Default: 

Definition: 



Example: 



EP/NOEP 

(Filename) (Indicates file to receive error messages — argument 
optional. ) 

Primary 

NOERRORPRINT 

When ERRORPRINT is in effect, indicates that all erroneous 
lines of source and the corresponding error message shall be out- 
put to the specified file. This will not inhibit errors from being 
placed in listing file. If no argument is specified to 
ERRORPRINT, then erroneous lines and error messages will be 
displayed at the console. 

$ERRORPRINT 
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Control Switch Name: GEN/GENONLY/NOGEN 



Abbreviation: GE/GO/NOGE 

Arguments: None 

Control Class: General 

Default: GENONLY 
Definition: 



Example: 



NOGEN indicates that only the contents of the source file shall be 
output to the listing file with macro call expansion not shown. 
Expansion will take place, but source lines generated will not be 
displayed in listing file, only the macro call. 

GENONLY indicates that only the fully expanded macro calls will 
appear in the listing. The listing file appears as if the expanded 
text was originally in the source file with no macro calls. The 
macro calls will not be displayed, but the source lines generated by 
the calls will be in the listing file. 

GEN indicates that each macro call shall be expanded showing 
nesting of macro calls. The macro call and the source lines 
generated by the macro call will be displayed in the listing file. 

These controls are overridden by NOPRINT and NOLIST. (See 
Chapter 7 for examples of a macro calls listed with GEN, 
GENONLY and NOGEN in effect.) 

$NOGEN 



Control Switch Name: INCLUDE 



Abbreviation: 
Arguments: 
Control Class: 
Default: 
Definition: 



Example: 



IC 

(Filename) (Identifies file to be included into program) 

General 

Not applicable. 

Inserts the contents of the file specified in the argument into the 
program immediately following the control line. INCLUDE files 
may be nested. 

The INCLUDE control may not appear in the invocation line, 
and it terminates processing of primary controls in the source. 

$INCLUDE(:F1:IOPACK.SRC) 
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Control Switch Name: 



LIST/NOLIST 



Abbreviation: LI/NOLI 

Arguments: None 

Control Class: General 

Default: LIST 



Definition: 



Example: 



Indicates whether subsequent lines of source text shall be 
displayed in listing file. A LIST control following a NOLIST will 
not be displayed, but listing will continue with the next sequential 
line. NOPRINT overrides LIST. 

NOTE 

Lines causing errors will be listed when NOLIST is in 
effect. 

$NOLIST 



Control Switch Name: MACRO/NOMACRO 



Abbreviation: MR/NOMR 

Arguments: (mempercent) (Optional. Indicates the percentage of the free 
m em ory to be used for macro processing. ) 

Control Class: Primary 

Default: MACRO(50) 

Definition: Indicates whether macro calls shall be expanded. If NOMACRO 

is specified all macro calls will not be processed as macros. The 
NOMACRO control will free additional symbol table space for 
user-defined symbols. 

Example: $NOMACRO 

$MACRO(30) 
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Control Switch Name: 



OBJECT/NOOBJECT 



Abbreviation: OJ/NOOJ 

Arguments: (Filename) (Indicates file to receive object code—argument 
optional. ) 

Control Class: Primary 

Default: OBJECT(so(/rce//7e.OBJ) 

Definition: Indicates whether object code shall be generated, and if so, the 

file that will receive it. If you do not specify the argument, the 
object file will be source file. OB], 

Example: $OBJECT(:F1:FINAL.REV) 



Control Switch Name: PAGING/NOPAGING 



Abbreviation: 
Arguments: 
Control Class: 
Default: 
Definition: 



Example: 



PI/NOPI 

None 

Primary 

PAGING 

Indicates whether page breaks shall be included in listing file. If 
NOPAGING, then there will be no page breaks in the file, and 
lines will appear listed consecutively. A single header will be 
included at the top of the file. EJECT and PAGELENGTH 
controls will be ignored. 

If PAGING, a formfeed and a page header will be inserted into 
the listing file whenever the number of lines since the last page 
break equals the PAGELENGTH value, or an EJECT control is 
encountered. The header includes the assembler designation, the 
name of the source file, the TITLE and DATE strings (if 
specified), and the page number. 

$ NOPAGING 
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Control Switch Name: PAGELENGTH 

Abbreviation: PL 

Arguments: (n) (Decimal number greater than 9.) 

Control Class: Primary 

Default: PAGELENGTH(60) 

Definition: Indicates the maximum number of printed lines on each page of 

the listing file. This number includes the page heading. The 
minimum value for PAGELENGTH is 10. Values less than 10 will 
be treated as 10. The maximum value permitted in the argument is 
65,535. 

Example: $ PAGELENGTH(132) 



Control Switch Name: PAGEWIDTH 



Abbreviation: 
Arguments: 
Control Class: 
Default: 
Definition: 



Example: 



PW 

(n) {Number indicates maximum characters per line. ) 

Primary 

PAGEWIDTH(120) 

Indicates the maximum number of characters printed on a line in 
the listing file. The range of values permitted is from 80 to 132; 
values less than 80 are set to 80; values greater than 132 are set to 
132. 

Listing lines that exceed the PAGEWIDTH value will be wrapped 
around on the next lines in the listing, starting at column 80. 

$ PAGEWIDTH(80) 
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Control Switch Name: PRINT/ NOPRINT 



Abbreviation: PR/NOPR 

Arguments: (Filename) (Indicates file to receive assembler listing- 
argument optional.) 

Control Class: Primary 

Default: PRINT(so(irce//7e.LST) 

Definition: Indicates whether formatted source listing shall be generated, 

and, if so, what file will receive it. If you do not specify the argu- 
ment, the listing file will be sourcefile. LST. NOPRINT indicates 
no listing file will be made. 

Example: -ASM51 PROG. SRC PRINT(:LP:) & print listing at line printer 



Control Switch Name: 



SAVE /RESTORE 



Abbreviation: SA/RS 
Arguments: None 
Control Class: General 



Default: 
Definition: 



Example: 



Not applicable 

Permits you to save and restore the state of the LIST and GEN 
controls. SAVE stores the setting of these controls on the SAVE 
stack, which is internal to the assembler. RESTORE restores the 
setting of the controls to the values most recently saved, but not 
yet restored. SAVEs can be nested to a depth of 8. 

NOTE 

SAVE uses the values that were in effect on the line prior 
to the SAVE control line. Therefore, if the LIST control 
is in effect and the assembler encounters a control line 
containing NOLIST and SAVE (in any order on the line), 
the status LIST is saved on the stack. (The lines following 
the control line are not listed until a LIST or RESTORE 
is encountered.) 

$save 
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Control Switch Name: REGISTERBANK / NOREGISTERBANK 

Abbreviation: RB / NORB 

Arguments: (rb, ...) (One or more of the permissable bank 

rb = 0, 1 , 2, or 3 numbers separated by commas.) 

Control Class: Primary 

Default: REGISTERBANK(O) 

Definition: Indicates the register banks used in the program module. This 

information is transferred to the RL51 and used for allocation of 
register bank memory. NORB specifies that no memory is initially 
reserved for register banks. Note that the USING directive also 
reserves register banks. 

Example: REGISTERBANK(0,1) 



Control Switch Name: SYMBOLS/NOSYMBOLS 

Abbreviation: SB/NOSB 

Argument: None 

Control Class: Primary 

Default: SYMBOLS 

Definition: Indicates whether a symbol table shall be listed. NOSYMBOLS 

indicates no symbol table. SYMBOLS causes the table to be 
listed. NOSYMBOLS is overridden by XREF. SYMBOLS is over- 
ridden by NOPRINT. (See Chapter 7 for an example symbol table 
listing.) 

Example: SNOSYMBOLS 
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Control Switch Name: TITLE 

Abbreviation: TT 

Arguments: (string) (Up to 60 characters.) 

Control Class: General 

Default: (Spaces Inserted) 

Definition: Permits you to include a title for the program. It will be printed in 

the header of every subsequent page. Titles longer than 60 
characters will be truncated to the first 60 characters. (See 
Chapter 7 for an example of the title in the header.) 

NOTE 

Any parentheses in the TITLE string must be balanced. 

Example: $TITLE(Final Production Run) 



Control Switch Name: WORKFILES 

Abbreviation: WF 

Arguments: (:Fm:[,:Fn:]) (Drives to use for temporary work files—second 
argument optional) 

Control Class: Primary 

Default: Drive that contains source file. 

Definition: Indicates drives to be used to contain temporary workfiles. If two 

drives are specified, the workfiles are split between them roughly 
equally. If only one drive is specified, then all workfiles will be 
placed on that drive. All workfiles are deleted before normal 
termination. 

Example: - ASM51 :F1:BIGPR.SRC WORKFILES(:F4:,:F5:) 
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Control Switch Name: XREF/NOXREF 

Abbreviation: XR/NOXR 

Arguments: None 

Control Class: Primary 

Default: NOXREF 

Definition: Indicates that a cross reference table of the use of symbols shall be 

added to the symbol table. Each cross reference table will list the 
line numbers of the lines that define the value of a symbol, and ail 
of the lines that reference the symbol. A hash mark (#) follows the 
numbers of the lines that define the symbols value. XREF is over- 
ridden by NOPRINT. (See Chapter 7 for an example of a symbol 
table listing with XREF.) 

Example: $XREF 
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CHAPTER 7 

ASSEMBLER OUTPUT: ERROR 

MESSAGES AND LISTING FILE FORMAT 



This chapter discusses the meaning of error messages issued by ASM51 . The format of the 
listing file is also described. 



Error Messages and Recovery 



All error messages issued by ASM51 are either displayed on the console or listed in the 
listing file. Fatal errors, such as invocation line errors, are listed at the console and cause 
ASM51 to abnormally terminate. Errors detected in the source file do not cause the 
assembler to abort and usually allow at least the listing to continue. 

Console Error Messages 

Upon detecting certain catastrophic conditions with the system hardware, or in the invo- 
cation line or one of the primary control lines, ASM51 will print an informative message 
at the console and abort processing. 

These errors fall into three broad classes: I/O errors, internal errors and invocation line 
errors. 

A list of these fatal control error messages and a description of the cause of each is shown 
below. 

I/O Errors 

I/O error messages print with the following format: 

ASM51 I/O ERROR- 
FILE: file type 
NAME: filename 
ERROR: ISIS error number and brief description 

ASM51 TERMINATED 

The list of possible file types is: 

SOURCE 

PRINT 

OBJECT 

INCLUDE 

ERRORPRINT 

ASM51 WORKFILE 

ASM51 OVERLAY number 

The list of possible error numbers is: 

4-ILLEGAL PATH NAME 

5-ILLEGAL OR UNRECOGNIZED DEVICE IN PATH 

9-DIRECTORY FULL 

12— ATTEMPT TO OPEN ALREADY OPEN FILE 
13-NO SUCH FILE 
14-WRITE PROTECTED FILE 

22-OUTPUT MODE IMPOSSIBLE FOR SPECIFIED FILE 
23-NO FILENAME SPECIFIED FOR A DISK FILE 
28-NULL FILE EXTENSION 
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ASMS 1 Internal Errors 

The ASM51 internal errors indicate that an internal consistency check failed. A 
likely cause is that one of the files containing the assembler's overlays was corrupted 
or that a hardware failure occurred. If the problem persists, contact Intel Corpora- 
tion via the Software Problem report. 

These messages print in the following format: 

****ASM51 INTERNAL ERROR: message 

Be sure to include the exact text of the message on the problem report. 



Invocation Line Errors 

The invocation line error messages print in the following format: 

ASM51 FATAL ERROR- 
error message 

The possible error messages are: 

NO SOURCE FILE FOUND IN INVOCATION 

If ASM51 scans the invocation line and cannot find the source file name, then this 
error will be issued and assembly aborted . 

UNRECOGNIZABLE SOURCE FILE NAME 

If the first character after "ASM51" on the invocation line is not an "&" or a file 
character (i.e., ":", letter, digit, "."), then ASM51 issues this error and aborts. 

ILLEGAL SOURCE FILE SPECIFICATION 

If the source file is not a legal file name (does not conform to the ISIS-II rules for a 
path name), then this error is issued. 

SOURCE TEXT MUST COME FROM A FILE 

The source text must always come from a file, not devices like :TI: or :LP: . 

NOT ENOUGH MEMORY 

If there is not enough memory in your SERIES-II or MDS 800, then this error 
message will print out and ASM5 1 will abort. 

If identical files are specified: 

_ AND _ FILES ARE THE SAME 

where the "_" can be any of SOURCE, PRINT, OBJECT, and ERRORPRINT. It 
doesn't make sense for any of these files to be the same. 

BAD WORKFILES COMMAND 

If a WORKFILES control has no parameters (i.e., devices) or a device specification 
is incorrect, this error message is issued. 

BAD WORKFILES SYNTAX 
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If ASM51 encounters anything other than a "," or a ")" when it is looking for the 
next workfile, then this error is issued. 

BAD PAGELENGTH 
BAD PAGEWIDTH 

The parameter to pagelength and pagewidth must be a decimal number. The number 
may have leading and trailing blanks, but if there are any other extra characters in 
the parameter, then this error will be issued. 

PAGELENGTH MISSING A PARAMETER 
PAGEWIDTH MISSING A PARAMETER 
DATE MISSING A PARAMETER 

These commands require parameters. If there is no parameter, then assembly is 
aborted. 

CANNOT HAVE INCLUDE IN INVOCATION 

The INCLUDE command may appear only in the source text. Don't forget that 
command lines in the source file can contain primary commands, but only if they are 
the very first lines in the file. Also, if one of these lines has an INCLUDE on it, then 
that ends the primary command lines. 

EOL ENCOUNTERED IN PARAMETER 

A parameter in the invocation line is missing a right parenthesis. 

COMMAND TOO LONG 
A command word longer than 128 characters— very unlikely. 

ILLEGAL CHARACTER IN INVOCATION 

There was an illegal character in the invocation line— usually a typing error. (See 
error 403.) 

UNRECOGNIZED COMMAND: <controf-name> 
This message is issued if a problem occurs in the invocation. 

NO PARAMETER ALLOWED WITH control 
The control specified may not be associated with the parameter. 

TITLE MISSING A PARAMETER 
The TITLE control was specified without the title string itself as a parameter. 

TOO MANY RESTORES 
More RESTORE controls encountered than the respective SAVE controls. 

NO PARAMETER GIVEN FOR "REGISTERBANKS" 

The REGISTERBANKS control was specified without the register bank numbers 
as parameters. 

ERROR IN PARAMETER LIST FOR "REGISTERBANKS" 

The parameter list of the REGISTERBANKS control contains an error. 
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Listing File Error Messages 

ASM51 features an advanced error-reporting mechanism. Some messages pinpoint 
the symbol or character at which the error was detected. Error messages printed in 
the source file are inserted into the listing after the lines on which the errors were 
detected. 

They are of the following format: 

* * * ERROR #eee , LIN E #/// {ppp ) , message 

where: 

eee is the error number 

/// is the number of the line on which the error occurred 

ppp is the line containing the last previous error 

message is the English message corresponding to the error number 

If the error is detected in pass 2, the clause "(PASS 2)" precedes the message. 
"(MACRO)" precedes the message for macro errors; "(CONTROL)" precedes the 
message for control errors. 

Errors which refer to character or symbol in a particular line of the source file do so 
by printing a pointer to the first item in the line that is not valid; e.g.: 



The up arrow or vertical bar points to the first incorrect character in the line. 

Error messages that appear in the listing file are given numbers. The numbers corres- 
pond to classes of errors. The classes of errors and the numbers reserved for these 
classes is shown in the list below : 

0-99 Source File Errors 

300 - 399 Macro Errors 

400 - 499 Control Errors 

800 - 899 Special Assembler Errors 

900 - 999 Fatal Errors 

Errors numbered less than 800 are ordinary, non-fatal errors. Assembly of the error 
line can usually be regarded as suspect, but subsequent lines will be assembled. If an 
error occurs within a macro definition, the definition does not take place. 



Source File Error Messages 

There follows a list of the error messages generated by ASM51, ordered by error 
number. 



** ERROR #1 SYNTAX ERROR 

This message is preceded by a pointer to the character at which the syntax error 
was detected. 
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ASM51 contains an internally-encoded grammar of the MCS-5 1 assembly 
language and requires your program to conform to that grammar. The syntax 
error is recognized at the item indicated in the error message; e.g., 

...TEMPSER10 



gives a syntax error at the S. "SER" is unrecognized. However, sometimes the 
error is not detected until one or more characters later; e.g., 

...SETBEQU1 



gives a syntax error at "EQU". The error is that SETB is already defined as an 
instruction. The assembler interprets the line as a SETB instruction with 
"EQU 1" as the operand field. Since the keyword "EQU" is not a legal 
operand the "EQU" is flagged, even though the "SETB" is the user's 
mistake. 

ASM5 1 discards the rest of the line when it finds a syntax error. 

*** ERROR #2 SOURCE LINE LISTING TERMINATED AT 255 CHARACTERS 

Listing of the source line was stopped at 255 characters. The entire line was 
interpreted, only the listing is incomplete. 

*** ERROR #3 ARITHMETIC OVERFLOW IN NUMERIC CONSTANT 

This error is reported whenever the value expressed by a constant exceeds the 
internal representation of the assembler (65,535). 

*** ERROR #4 ATTEMPT TO DIVIDE BY ZERO 

This error occurs when the right hand side of a division or MOD operator 
evaluates to zero. 

*** ERROR #5 EXPRESSION WITH FORWARD REFERENCE NOT ALLOWED 

Forward references are permitted only in the expression argument to DB, DW, 
and machine instructions. Change the expression to remove the forward 
reference, or define the symbols earlier in the program. 

*** ERROR #6 TYPE OF SET SYMBOL DOES NOT ALLOW REDEFINITION 

This error occurs when the symbol being defined in a SET directive is a 
predefined assembler symbol or has been previously defined not using SET 
directive. For example, the following lines would cause this error on the 
second line. 

SKIP__1:ADDA,R1 
SKIP_1SET22D 

*** ERROR #7 SYMBOL ALREADY DEFINED 

This message is given when the symbol has already been defined. To correct 
this error, use a different symbol name. 

*** ERROR #8 ATTEMPT TO ADDRESS NON-BIT-ADDRESSABLE BIT 
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This error is caused when the left hand side of the bit selector (.) is not one of 
the bit addressable bytes. (See errors 40 and 9.) Figure 2-2 shows all bit- 
addressable bytes. Several examples of lines that would cause this type of error 
are shown below. 

JB10H.5,LOOP 

CLR7FH.0 

MOVC,0AFH.3 

*** ERROR #9 BAD BIT OFFSET IN BIT ADDRESS EXPRESSION 

This error is caused when the right hand side of the bit selector (.) is out of 
range (0-7). The assembler uses in its place. The byte address, if correct, 
remains the same. (See errors 8, and 40.) Several examples of lines that would 
generate this error are shown below. 

CLR25H.10 
SETB26H.5 + 4 
CPLPSW.-1 

*** ERROR #10 TEXT FOUND BEYOND END STATEMENT -IGNORED 

This is a warning— there are no ill effects. The extra text appears in the listing 
file, but it is not assembled. 

*** ERROR #11 PREMATURE END OF FILE (NO END STATEMENT) 

There are no ill effects from omitting the END statement, other than this 
message. 

*** ERROR #12 ILLEGAL CHARACTER IN NUMERIC CONSTANT 

Numeric constants begin with decimal digits, and are delimited by the first 
non-numeric character. The set of legal characters for a constant is determined 
by the base: 

1. Base 2: 0,1, and the concluding B. 

2. Base 8: 0-7, and the concluding Q or O. 

3. Base 10: 0-9, and the concluding Dor null. 

4. Base 16: 0-9, A-F, and the concluding H. 

*** ERROR #13 ILLEGAL USE OF REGISTER NAME IN EXPRESSION 

This error is caused by placing a forward reference symbol, defined as a 
register, in a numeric expression. An example of this type of error is shown 
below: 

DBREG0 
REG0 EQU R0 

*** ERROR #14 SYMBOL IN LABEL FIELD ALREADY DEFINED 

You can define a label only once in your program. If the symbol name has 
been defined anywhere else in the program this error will be generated. 

*** ERROR #15 ILLEGAL CHARACTER 

This message is preceded by a pointer to the illegal character. 
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A character that is not accepted by ASM51 was found in the input file. Either 
it is an unprintable ASCII character, in which case it is printed as an up arrow 
( A ), or it is printable but has no function in the assembly language. Edit the 
file to remove the illegal character. 

*** ERROR #16 MORE ERRORS DETECTED, NOT REPORTED 

After the ninth source file Error on a given source line, this message is given 
and no more errors are reported for that line. Normal reporting resumes on the 
next source line. (See errors 300 and 400.) 

*** ERROR #17 ARITHMETIC OVERFLOW IN LOCATION COUNTER 

This error is reported whenever the DS, DBIT, or ORG directive attempts to 
increase the location counter beyond the limits of the current address space. 
This may occur, for example, in CSEG when instructions cause the location 
counter to increment above 65,535. 

*** ERROR #18 UNDEFINED SYMBOL 

This error is reported when an undefined symbol occurs in an expression. Zero 
is used in its place— this may cause subsequent errors. 

*** ERROR #19 VALUE WILL NOT FIT INTO A BYTE 

This error is issued whenever the expression used for a numeric operand that is 
encoded as a single byte is not in the range -256 to +255. 

*** ERROR #20 OPERATION INVALID IN THIS SEGMENT 

This error will occur if you use the DBIT directive not in a BIT type segment; 
or a DS directive in a BIT type segment, or if you attempt to initialize memory 
(use DB, DW, or a machine instruction) in a segment with different type than 
CODE. 

*** ERROR #21 STRING TERMINATED BY END-OF-LINE 

All strings must be completely contained on one line. 

*** ERROR #22 STRING LONGER THAN 2 CHARACTERS NOT ALLOWED IN THIS CONTEXT 

Outside of the DB directive all strings are treated as absolute numbers; hence, 
strings of 3 or more characters are overflow quantities. If this error occurs in a 
DW directive, you probably should be using DB. 

*** ERROR #23 STRING, NUMBER, OR IDENTIFIER CANNOT EXCEED 255 CHARACTERS 

The maximum length of a character string (including surrounding quotes), a 
number, or an identifier is 255 characters. 



*** ERROR #24 DESTINATION ADDRESS OUT OF RANGE FOR INBLOCK REFERENCE 

This error is caused by specifying an address that is outside the current 2K byte 
block. The current block is defined by the five most significant bits of the 
address of the next instruction. 
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*** ERROR #25 DESTINATION ADDRESS OUT OF RANGE FOR RELATIVE REFERENCE 

A relative jump has a byte range (-128 to +127) from the instruction that 
follows the jump instruction. Any address outside of this range will generate 
this error. You can correct this error in one of two ways: if the jump has a 
logical complement (e.g., JC and JNC), the following change could be made: 

JCTOP to JNC SKIP 

JMPTOP 
SKIP: 

If the instruction has no logical complement, then the following change could 
be made 

DJNZRO.TOP to DJNZR0,SKIP__1 

JMPSKIP_2 
SKIP__1: JMPTOP 
SKIP_2: 

*** ERROR #26 SEGMENT SYMBOL EXPECTED 

The error occurs when the symbol specified by the RSEG directive is not a seg- 
ment symbol, i.e., is not defined previously using the SEGMENT directive. 

>** ERROR #27 ABSOLUTE EXPRESSION EXPECTED 

The error occurs when the operand to the following directives is not absolute: 
DS, DBIT, USING, CSEG, XSEG, DSEG, BSEG, and ISEG. In addition, the 
bit-offset in a byte. bit form should also be absolute. 

'** ERROR #28 REFERENCE NOT TO CURRENT SEGMENT 

The error occurs in two cases: if a relocatable expression in an ORG directive 
does not specify the current active segment; or if the absolute expression speci- 
fying the base address in a segment select directive is not of the correct segment 
type. 

Examples 

RSEG CODE__SEG1 
CODE_SYM1: DB1 

RSEG DATA_SEG1 

ORG CODE__SYMB1 ;error#28 

CODE_SYMB2 CODE 200H 

DSEG AT CODE_SYM2 ;error #28 

*** ERROR #29 IDATA SEGMENT ADDRESS EXPECTED 

The symbol specified on the left hand side of the bit selector(.) is not segment 
type DATA, or not in a bit-addressable relocatable type segment. The numeric 
value is used if possible, but may cause other errors. (See errors 37 and 8.) 

*** ERROR #30 PUBLIC ATTRIBUTE NOT ALLOWED FOR THIS SYMBOL 

Occurs if the user attempts to define as public either segment symbols, external 
symbols, or predefined symbols. 

*** ERROR #31 EXTERNAL REFERENCE NOT ALLOWED IN THIS CONTEXT 
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*** ERROR #32 SEGMENT REFERENCE NOT ALLOWED IN THIS CONTEXT 

Occurs if an external/segment symbol appears in a symbol definition directive 
(EQU, SET, DATA, etc.); or in contexts when absolute expressions are 
required (see error #27). 

*** ERROR #33 TOO MANY RELOCATABLE SEGMENTS 

The maximum number of relocatable segments has been exceeded. 
*** ERROR #34 TOO MANY EXTERNAL SYMBOLS 

The maximuniinumber of relocatable segments has been exceeded. 

*** ERROR #35 LOCATION COUNTER MAY NOT POINT BELOW SEGMENT BASE 

Occurs if the user attempts, using the ORG directive, to set the location 
counter below the beginning of the current absolute segment. 

Example 

CSEG AT 200H ;starts an absolute segment at 200H 
ORG 1FFH ;error#35 

*** ERROR #36 CODE SEGMENT ADDRESS EXPECTED 
*** ERROR #37 DATA SEGMENT ADDRESS EXPECTED 
*** ERROR #38 XDATA SEGMENT ADDRESS EXPECTED 
••* ERROR #39 BIT SEGMENT ADDRESS EXPECTED 

These errors are caused by specifying a symbol with the wrong segment type in 
an operand to an instruction. The numeric value of that symbol is used, but it 
may cause subsequent errors (e.g., error 17). 

*** ERROR #40 BYTE OF BIT ADDRESS NOT IN BIT ADDRESSABLE DATA SEGMENT 

The symbol specified on the left hand side of the bit selector (.) is not segment 
type DATA, or not in a bit-addressable relocatable type segment. The numeric 
value is used if possible, but may cause other errors. (See errors 37 and 8.) 

*** ERROR #41 INVALID HARDWARE REGISTER 

The data address specified in the expression points to an unidentified location 
in the hardware register space (128 to 255). 

*** ERROR #42 BAD REGISTER BANK NUMBER 

The register bank number specified for the USING directive should be in the 
range of to 3. 

•** ERROR #43 INVALID SIMPLE RELOCATABLE EXPRESSION 

Symbol definition directives such as EQU, SET, DATA, CODE, etc., require 
a simple relocatable expression (or a special register symbol in the EQU/SET 
case). See Chapter 2. 

*** ERROR #44 INVALID RELOCATABLE EXPRESSION 

The relocatable expression specified violates the rules of relocatable expres- 
sions as given in Chapter 2. 
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' ERROR #45 INPAGE RELOCATED SEGMENT OVERFLOW 

' ERROR #46 INBLOCK RELOCATED SEGMENT OVERFLOW 

' ERROR #47 BITADDRESSABLE RELOCATED SEGMENT OVERFLOW 

The relocatability of the current active segment specifies a limited segment 
size: INPAGE = maximum 256 bytes; INBLOCK = 2048 bytes; 
BITADDRESSABLE = 16 bytes. 

ERROR #48 ILLEGAL RELOCATION FOR SEGMENT TYPE 

The segment type and relocatability of the defined segment is an invalid com- 
bination. See Chapter 4 on segment definition directive. 



Macro Error Messages 

Error messages with numbers in the 300's indicate macro call/expansion errors. 
Macro errors are followed by a trace of the macro call/expansion stack — a series of 
lines which print out the nesting of macro calls, expansions, INCLUDE files, etc. 

Processing resumes in the original source file, with all INCLUDE files closed and 
macro calls terminated. 

*** ERROR #300 MORE ERRORS DETECTED, NOT REPORTED 

After 100 Macro or Control Errors on a given source line, this message is given 
and no more errors are reported for that line. Normal reporting resumes on the 
next source line. If the last error reported is a Macro Error, then this message 
will be issued. (See errors 16 and 400.) 

*** ERROR #301 UNDEFINED MACRO NAME 

The text following a metacharacter (%) is not a recognized user function name 
or built-in function. The reference is ignored and processing continues with the 
character following the name. 

*** ERROR #302 ILLEGAL EXIT MACRO 

The built-in macro "EXIT" is not valid in this context. The call is ignored. A 
call to "EXIT" must allow an exit through a user function, or the WHILE or 
REPEAT built-in functions. 

*** ERROR #303 FATAL SYSTEM ERROR 

Loss of hardware and/or software integrity was discovered by the macro 
processor. Contact Intel Corporation. 

*** ERROR #304 ILLEGAL EXPRESSION 

A numeric expression was required as a parameter to one of the built-in 
macros EVAL, IF, WHILE, REPEAT, and SUBSTR. The built-in function 
call is aborted, and processing continues with the character following the 
illegal expression. 

*** ERROR #305 MISSING "Fl" IN "IF" 

The IF built-in function did not have a FI terminator. The macro is processed, 
but may not be interpreted as you intended. 
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*** ERROR #306 MISSING "THEN" IN "IF" 

The IF built-in macro did not have a THEN clause following the conditional 
expression clause. The call to IF is aborted and processing continues at the 
point in the string at which the error was discovered. 

*** ERROR #307 ILLEGAL ATTEMPT TO REDEFINE MACRO 

It is illegal for a built-in function name or a parameter name to be redefined 
(with the DEFINE or MATCH built-ins). Also, a user function cannot be 
redefined inside an expansion of itself. 

*** ERROR #308 MISSING IDENTIFIER IN DEFINE PATTERN 

In DEFINE, the occurrence of "@" indicated that an identifier type delimiter 
followed. It did not. The DEFINE is aborted and scanning continues from the 
point at which the error was detected. 

*** ERROR #309 MISSING BALANCED STRING 

A balanced string "(•••)" in a call to a built-in function is not present. The 
macro function call is aborted and scanning continues from the point at which 
the error was detected. 

*** ERROR #310 MISSING LIST ITEM 

In a built-in function, an item in its argument list is missing. The macro func- 
tion call is aborted and scanning continues from the point at which the error 
was detected. 

*** ERROR #311 MISSING DELIMITER 

A delimiter required by the scanning of a user-defined function is not present. 
The macro function call is aborted and scanning continues from the point at 
which the error was detected , 

This error can occur only if a user function is defined with a call pattern con- 
taining two adjacent delimiters. If the first delimiter is scanned, but is not 
immediately followed by the second, this error is reported. 

*** ERROR #312 PREMATURE EOF 

The end of the input file occurred while the call to the macro was being 
scanned. This usually occurs when.a delimiter to a macro call is omitted, caus- 
ing the macro processor to scan to the end of the file searching for the missing 
delimiter. 

Note that even if the closing delimiter of a macro call is given, if any preceding 
delimiters are not given, this error may occur, since the macro processor 
searches for delimiters one at a time. 

*** ERROR #313 DYNAMIC STORAGE (MACROS OR ARGUMENTS) OVERFLOW 

Either a macro argument is too long (possibly because of a missing delimiter), 
or not enough space is available because of the number and size of macro 
definitions. All pending and active macros and INCLUDED are popped and 
scanning continues in the primary source file. Increase the mempercent 
parameter of the MACRO control to overcome this error. 
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*** ERROR #314 MACRO STACK OVERFLOW 

The macro context stack has overflowed. This stack is 64 deep and contains an 
entry for each of the following: 

1. Every currently active input file (primary source plus currently nested 
INCLUDE's). 

2. Every pending macro call, that is, all calls to macros whose arguments are 
still being scanned. 

3. Every active macro call, that is, all macros whose values or bodies are 
currently being read. Included in this category are various temporary 
strings used during the expansion of some built-in macro functions. 

The cause of this error is excessive recursion in macro calls, expansions, or 
INCLUDE's. All pending and active macros and INCLUDE's are popped and 
scanning continues in the primary source file. 



ERROR #315 INPUT STACK OVERFLOW 

The input stack is used in conjunction with the macro stack to save pointers to 
strings under analysis. The cause and recovery is the same as for the macro 
stack overflow. 



ERROR #317 PATTERN TOO LONG 

An element of a pattern, an identifier or delimiter, is longer than 31 
characters, or the total pattern is longer than 255 characters. The DEFINE is 
aborted and scanning continues from the point at which the error was 
detected. 



ERROR #318 ILLEGAL METACHARACTER: "char" 

The METACHAR built-in function has specified a character that cannot 
legally be used as a metacharacter: a blank, letter, digit, left or right paren- 
thesis, or asterisk. The current metacharacter remains unchanged. 



ERROR #319 UNBALANCED ")" IN ARGUMENT TO USER DEFINED MACRO 

During the scan of a user-defined macro, the parenthesis count went negative, 
indicating an unmatched right parenthesis. The macro function call is aborted 
and scanning continues from the point at which the error was detected. 



ERROR #320 ILLEGAL ASCENDING CALL 

Ascending calls are not permitted in the macro language. If a call is not com- 
plete when the end of a macro expansion is encountered, this message is issued 
and the call is aborted. A macro call beginning inside the body of a user- 
defined or built-in macro was incompletely contained inside that body, fj 
possibly because of a missing delimiter for the macro call. 
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Control Error Messages 

Control error messages are issued when something is wrong with a control line in the 
source file. Command language errors, when they occur in the invocation line or in a 
primary control line, are fatal. However, the errors listed below are not considered 
fatal. (See INVOCATION LINE ERRORS, described above.) 

*** ERROR #400 MORE ERRORS DETECTED, NOT REPORTED 

After 100 Macro or Control Errors on a given source line, this message is given 
and no more errors are reported for that line. Normal reporting resumes on the 
next source line. If the last error reported is a Control Error, then this message 
will be issued. (See errors 16 and 300.) 

*** ERROR #401 BAD PARAMETER TO CONTROL 

What appears to be the parameter to a control is not correctly formed. This 
may be caused by the parameter missing a right parenthesis or if the paren- 
theses are not correctly nested. 

*** ERROR #402 MORE THAN ONE INCLUDE CONTROL ON A SINGLE LINE 

ASM51 allows a maximum of one INCLUDE control on a single line. If more 
than one appears on a line, only the first (leftmost) is included, the rest are 
ignored. 

*** ERROR #403 ILLEGAL CHARACTER IN COMMAND 

When scanning a command line, ASM51 encountered an invalid character. 

This error can be caused for a variety of reasons. The obvious one is that a 
command line was simply mistyped. The following example is somewhat less 
obvious: 

$TITLE(*1)-GO') 

The title parameter ends with the first right parenthesis, the one after the digit 
1. The title string is i0 l". The next character "-" is illegal and will get error 
403. The next two characters, "GO", form a valid command (the abbreviation 
for GENONLY) which will cause the listing mode to be set. The final two 
characters "')" will each receive error 403. 

*** ERROR #406 TOO M AN YWORKFILES- ONLY FIRST TWO USED 

This error occurs when you specify more than two devices in the parameters to 
the WORKFILES control. Only the first two are used and the remaining list of 
devices is ignored until the next right parenthesis. 

*** ERROR #407 UNRECOGNIZED CONTROL OR MISPLACED PRIMARY CONTROL: <control-name> 

The indicated control is not recognized as an ASM51 control in this context. It 
may be misspelled, mistyped, or incorrectly abbreviated. 

A misplaced primary control is a likely cause of this error. Primary control 
lines must be at the start of the source file, preceding all non-control lines 
(even comments and blank lines). 
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* * * ERROR #408 NO TITLE FOR TITLE CONTROL 

This error is issued if the title control has no parameter. The resulting title will 
be a string of blanks. 

•"ERROR #409 NO PARAMETER ALLOWED WITH ABOVE CONTROL 

The following controls do not have parameters: 



EJECT 


NOOBJECT 


NOMACRO 


SAVE 


NOPRINT 


PAGING 


RESTORE 


NOPAGING 


SYMBOLS 


LIST 


DEBUG 


NOSYMBOLS 


NOLIST 


NODEBUG 


XREF 


GENONLY 


NOERRORPRINT 


NOXREF 


GEN 


NOGEN 





If one is included, then this error will be issued, and the parameter will be 
ignored. 

*** ERROR #410 SAVE STACK OVERFLOW 

The SAVE stack has a depth of eight. If the program tries to save more than 
eight levels, then this message will be printed. 

*** ERROR #411 SAVE STACK UNDERFLOW 

If a RESTORE command is executed and there has been no corresponding 
SAVE command, then this error will be printed. 

*** ERROR #413 PAGEWIDTH BELOW MINIMUM, SET TO 80 

The minimum pagewidth value is 80. If a pagewidth value less than 80 is given, 
80 becomes the new pagewidth . 

*** ERROR #414 PAGELENGTH BELOW MINIMUM, SET T0 10 

The minimum number of printed lines per page is 10. If a value less than 10 is 
requested, 10 becomes the new pagelength. 

*** ERROR #415 PAGEWIDTH ABOVE MAXIMUM, SETT0 132 

The maximum pagewidth value is 132. If a value greater than 132 is requested 
then, 132 becomes the new pagewidth. 



Special Assembler Error Messages 

Error messages in the 800's should never occur. If you get one of these error 
messages, please notify Intel Corporation via the Software Problem Report included 
with this manual. All of these errors are listed below: 

*** ERROR #800 UNRECOGNIZED ERROR MESSAGE NUMBER 

*** ERROR #801 SOURCE FILE READING UNSYNCHRONIZED 

*** ERROR #802 INTERMEDIATE FILE READING UNSYNCHRONIZED 

*" ERROR #803 BAD OPERAND STACK POP REQUEST 

*** ERROR #804 PARSE STACK UNDERFLOW 

*** ERROR #805 INVALID EXPRESSION STACK CONFIGURATION 
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Fatal Error Messages 

Errors numbered in the 900's are fatal errors. They are marked by the line 

"*** FATAL ERROR***" 

preceding the message line. Assembly of the source code is halted. The remainder of 
the program is scanned and listed, but not assembled. 

*** ERROR #900 USER SYMBOL TABLE SPACE EXHAUSTED 

You must either eliminate some symbols from your program, or if you don't 
use macros, the NOMACRO control will free additional symbol table space. 

*** ERROR #901 PARSE STACK OVERFLOW 

*** ERROR #902 EXPRESSION STACK OVERFLOW 

This error will be given only for grammatical entities far beyond the complica- 
tion seen in normal programs. 

*** ERROR #903 INTERMEDIATE FILE BUFFER OVERFLOW 

This error indicates that a single source line has generated an excessive amount 
of information for pass 2 processing. In practical programs, the limit should 
be reached only for lines with a gigantic number of errors — correcting other 
errors should make this one go away. 

*** ERROR #904 USER NAME TABLE SPACE EXHAUSTED 

This error indicates that the sum of the number of characters used to define the 
symbols contained in a source file exceeds the macro processor's capacity. Use 
shorter symbol names, or reduce the number of symbols in the program. 



Assembler Listing File Format 



The MCS-5 1 assembler, unless overridden by controls, outputs two files: an object 
file and a listing file. The object file contains the machine code. The listing file con- 
tains a formatted copy of your source code with page headers and, if requested 
through controls (SYMBOL or XREF), a symbol table. 

MCS-51 MACRO ASSEMBLER SAMPLE PAGE 

ISIS-II MCS-51 MACRO ASSEMBLER V2.0 

OBJECT MODULE PLACED IN : F1 : S AMP1 . OB J 

ASSEMBLER INV0KE0 BY: ASM51 : M : S AM*1 . A51 DEBUG 

L0C 03J LINE SOURCE 

1 NAME SAMPLE 
2 

3 EXTRN code (put_crlf/ put_string* put.data.str , get.num) 

4 EXTRN code (binasc/ ascbin) 
5 

— — 6 CSEG 

7 ; This is the initializing section. Execution always 

8 ; starts at address on pouiei — up. 
0000 V ORG 

0000 753920 10 mov TMOD, *C01 00000B ; set timer mode to auto-reload 

0003 753003 11 mov THl/#(-253> ; set timer for 110 BAUD 

0006 75930A 12 tiov SCON , #1 1 01 1 01 0B ; prepare the Serial Port 



Figure 7-1 . Example Listing File Format 
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MCS-51 



MCS-51 MACRO ASSEMBLER 



SAMPLE 



LOC 08J 

0009 D2SE 



0006 900000 F 
000E 120000 p 
0011 120C00 F 



0014 


900000 


F 


0017 


120000 


F 


001A 


120000 


F 


001D 


7800 


F 


001F 


120000 


F 


0022 


120000 


F 


0025 


900000 


F 


0028 


120000 


r 


0028 


120000 


F 


002E 


7800 


p 


0030 


120000 


F 


0033 


120000 


F 


0036 


7900 


F 


0038 


120000 


F 


003B 


7900 


F 


0030 


120000 


F 


0040 


E500 


F 


0042 


2500 


F 


0044 


F500 


F 


0046 


7900 


F 


0048 


120000 


F 


004B 


900000 


F 


004E 


120000 


F 


0051 


7900 


F 


0053 


7A04 




0055 


120000 


F 


0058 


8031 





0008 



0000 
0004 
0008 



0000 54595045 
0004 205E5820 
0008 544F2052 
000C 45545950 
0010 45204120 
0014 4E554D42 
0018 4552 

001 A 00 



LINE 

13 
14 
15 
16 
17 
13 
19 
20 
21 
22 
23 
24 
25 
26 
Z7 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
63 
69 
70 



SOURCE 



setb TR1 



start clock 



; Thi 
; whe 
; inp 
START 
l typ 

IBOV 

call 

call 

/ get 

mov 

call 

call 

mov 

call 

call 

* get 
mov 
call 
call 
mov 
call 
call 

# con 
mov 
call 
mov 
call 

; add 

mov 

add 

mov 

; con 

mov 

call 

l out 

mov 

call 

mov 

mov 

call 

# 

OS 
STACK 



s is ths main program. It's an infinite loop/ 
re each iteration prompts the console for 2 

ut numoers and types out their sum. 

e message explaining horn to correct a typo 

DPTR/*typo.msg 

put. string 

put.crlf 

first number from console 
0PTR/ *num1.msg 
put.string 
put.crlf 
RQ/*num1 
get.num 
put.crlf 

second number from console 
DPTR/*num2.mss 
put. string 
put.crlf 
R0/#num2 
get.num 
put.crlf 

vert the ASCII numbers to binary 
R1s#num1 
ascbin 
R1,#num2 
ascbin 

the 2 numbers^ and store the results in SUM 
asnuml 
a/num2 
sum/* 

vert SUM from binary to ASCII 
R1/*sum 
binasc 

put sum to console 
DPTR/#sum_msg 
put. string 
R1s#sum 
R2,#4 

put.data.str 
start 



EG at 8 
ds 8 



i at power-up the stack pointer is 
'initialized to point here 



DATA. 

CONST 



RSEG 

NUM1 : 

NUM2: 

SUM: 

/ 

RSEG 

TYPO. 



AREA segment OATA 
ANT. AREA segment C00E 

data. area 
ds 4 

ds 4 
ds 4 



constant.area 
MSG: db 'TYPE A X TO RETYPE A NUM8ER'/00H 



Figure 7-1 . Example Listing File Format (Cont'd.) 
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MCS-51 MACRO ASSEMBLER 



SAMPLE 



0013 


54595045 


71 


001F 


20494E20 




3023 


46495253 




0027 


54204E55 




002B 


40424552 




002F 


3A20 




0031 


00 




0032 


54595045 


72 


0036 


20494E20 




003A 


5345434 c 




003E 


4E44204E 




0042 


554D4245 




0046 


523A20 




0049 


00 




004A 


54434520 


73 


004 = 


53554D20 




0052 


495320 




0055 


00 


74 
75 



NUM1.MSG: db 'TYPE IN FIRST NUMBER: # /00H 



NUM2.MSG: db 'TYPE IN SECOND NUMBER: %00H 



SUM.MSG: db 'THE SUM IS %00H 



END 



SYM30L TABLE LISTING 



NAME 



"TYPE 



VALUE 



ATTRIBUTES 



ASCBIN. . . . 


C 


AODR 







EXT 




3INASC. . . , 


C 


ADOR 







EXT 




CONSTANT. ARE/ 


I C 


SEG 


0056H 






REL=UNIT 


3ATA.AREA . , 





SEG 


OOOCH 






REL=UNIT 


GET.NUM . . , 


C 


AOOR 






EXT 




NUM1.MSG. • , 


C 


AOOR 


0013H 


R 




SEG=C3NSTANT_AREA 


NUMlI . . . . 


. 


AOOR 


OOOOH 


R 




SEG=DATA_AREA 


NUM2.MSG. . . 


. c 


AODR 


0032H 


R 




SEG=CONSTANT_AREA 


NUM2. . . . 


. 


AODR 


0004H 


R 




SEG=OATA_AR€A 


PUT.CRLF. . , 


. c 


AOOR 






EXT 




PUT.OATA.STR 


. c 


AODR 







EXT 




PUT. STRING. . 


. c 


AODR 







EXT 




SAMPLE. . . , 














SCON 


D 


ADOR 


0098H 


A 






STACK . . . . 


. D 


AOOR 


0008H 


A 






START . . . 


. C 


AOOR 


OOOBH 


A 






SUM.MSG . . 


. C 


AOOR 


004AH 


R 




ScG=CONSTANT.AREA 


SUM .... 


. 


AODR 


0008H 


R 




SEG-DATA.AREA 


TH1 . . . . 


. 


ADOR 


OOSDH 


A 






TMOD. . . . 


. 


AODR 


0039H 


A 






TR1 . . . . 


. a 


AOOR 


0033H.6 


A 






TYPO.MSG. . 


. c 


ADOR 


OOOOH 


R 




SEG=CONSTANT_AREA 



REGISTER BANK(S) USED: 0/ TARGET MACHINECS): 8051 
ASSEMBLY COMPLETE, NO ERRORS FOUND 



Figure 7-1 . Example Listing File Format (Cont'd.) 
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Listing File Heading 

Every page has a header on the first line. It contains the words "MCS-51 MACRO 
ASSEMBLER" followed by the title, if specified. If the title is not specified, then 
the module name is used. It is derived from the NAME directive (if specified), or 
from the root of the source filename. On the extreme right side of the header, the 
date (if specified) and the page number are printed. 

In addition to the normal header, the first page of listing includes a heading shown 
in figure 7-2. In it the assembler's version number is shown, the file name of the 
object file, if any, and the invocation line. The entire invocation line is displayed 
even if it extends over several lines. 



MCS-51 MACRO ASSEMBLER SAMPLE PAGE 1 

ISIS-II MCS-51 MACRO ASSEMBLER V2.0 

OBJECT MODULE PLACED IN : F1 : SAMP1 .OBJ 

ASSEMBLER INVOKED BY: :F1:ASM51 : F1 : SAMP1 . A51 DEBUG 

Figure 7-2. Example Heading 



Source Listing 

The main body of the listing file is the formatted source listing. A section of for- 
matted source is shown in figure 7-3 . 



LOC OBJ LINE SOURCE 

1 NAME SAMPLE 

2 ; 

3 EXTRN code (put_crlf, put_string, put_data__st r) 

4 EXTRN code (get_num, binasc, ascbin) 



5 



r 



6 CSEG 

7 ; This is the initializing section. Execution 

8 ; always starts at address on power-up. 
0000 9 ORG 

0000 758920 10 MOV TMOD , #001 00000B ; Set timer to auto-reload 

0003 758D03 11 MOV TH1,#(-253) ; Set timer for 110 BAUD 

0006 7598DA 12 MOV SCON ,#1101101 0B ; Prepare the Serial Port 

0009 D28E 13 SETB TR1 ; Start clock 

14 ; 

15 ; This is the main program. It's an infinite loop, 

16 ; where each iteration prompts the console for 2 

17 ; input numbers and types out their sum. 

18 START: 



Figure 7-3. Example Source Listing 
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The format for each line in the listing file depends on the source line that appears on 
it. Instruction lines contain 4 fields. The name of each field and its meaning is shown 
in the list below: 

• LOC shows the location relative or absolute (code address) of the first byte of 
the instruction. The value is displayed in hexadecimal. 

• OBJ shows the actual machine code produced by the instruction, displayed in 
hexadecimal. 

• If the object that corresponds to the printed line is to be fixed up (it contains 
external references or is relocatable), an "F" is printed after the OBJ field. The 
object fields to be fixed up contain zeroes. 

• LINE shows the INCLUDE nesting level, if any, the number of source lines 
from the top of the program, and the macro nesting level, if any. All values in 
this field are displayed in decimal numbers. 

• SOURCE shows the source line as it appears in the file. This line may be 
extended onto the subsequent lines in the listing file. 

DB or DW directives are formatted similarly to instruction lines, except the OBJ 
field shows the data values placed in memory. All data values are shown. If the 
expression list is long, then it may take several lines in the listing file to display all of 
the values placed in memory. The extra lines will only contain the LOC and OBJ 
fields. 

The directives that affect the location counter without initializing memory (e.g., 
ORG, DBIT, or DS) do not use the OBJ field, but the new value of the location 
counter is shown in the LOC field. 

The SET and EQU directives do not have a LOC or OBJ field. In their place the 
assembler lists the value that the symbol is set to. If the symbol is defined to equal 
one of the registers, then 'REG' is placed in this field. The remainder of the directive 
line is formatted in the same way as the other directives. 

Format for Macros and INCLUDE Files 

The format for lines generated by a macro call varies with the macro listing mode 
(GEN, GENONLY, or NOGEN). Figure 7-4 shows the format of the call macro 
calls listed with each of these modes in effect. In all three calls the same instructions 
are encoded, the only difference is in the listing of the macro call. Note that the 
macro nesting level is shown immediately to the right of the line number. 

3 +1 *GEN 

4 %add1 6(DPH,DPL,#( HIGH $),#( LOW $),DPH,DPL) 







5 


+ 1 








6 


♦ 1 


MOV A.fXLOW 


03E8 


E582 


7 


♦ 2 


DPL 






8 


+ 1 


ADD A.SYLOW 


03EA 


24EA 


9 


+2 


#(L0W $) 






10 


♦ 1 


MOV SSUMLOW 


03EC 


P582 


11 


♦ 2 


DPL, A 






12 


+ 1 


MOV A,%XHIGH 


03EE 


E583 


13. 


+ 2 


DPH 






14 


+ 1 


ADDC A.JYHIGH 


03F0 


3*03 


15 


+2 


#(HIGH 1) 






16 


♦ 1 


MOV SSUMHIGH 


03F2 


F583 


17 
18 
19 
20 
21 


+ 2 


DPH, A 






22 


+ 1 


IGENOMLY 






23 


♦ 1 




03F*t 


E582 


2* 


♦ 2 


MOV A, DPL 


03F6 


2UF6 


25 


+2 


ADD A,#(L0W $) 


03F8 


F582 


26 


+ 2 


MOV DPL, A 


03FA 


£583 


27 


4-2 


MOV A, DPH 


03FC 


3*03 


28 


♦2 


ADDC A,#(HIGH $) 


03FE 


F583 


29 
30 
31 
32 
33 


+2 

♦ 1 


MOV DPH,A 






34 


♦ 1 


4H0GEN 






35 




*add16(DPH,DPL,#<HIGH *),#(L0W $),DPH,DPL) 



Figure 7-4. Examples of Macro Listing Modes 
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General control lines that appear in the source are interpreted by ASM51's macro 
processor and, as such, they are given a macro nesting level value. It is displayed 
immediately to the right of the line number. Lines added to the program as a result 
of the INCLUDE control are formatted just as if they appeared in the original 
source file, except that the INCLUDE nesting level is displayed immediately to the 
left of the line number. 

The control line shown below has both an INCLUDE nesting level and a macro 
nesting level. The INCLUDE nesting level is preceded by a equal sign *=\ and the 
macro nesting level is preceded by a plus sign '+'. 

LOG OBJ LINE SOURCE 

=1 101 +1 $ SAVE NOLIST 



Symbol Table 

The symbol table is a list of all symbols defined in the program along with the status 
information about the symbol. Any predefined symbols used will also be listed in the 
symbol table. If the XREF control is used, the symbol table will contain information 
about where the symbol was used in the program. 

The status information includes a NAME field, a TYPE field, a VALUE field, and 
an ATTRIBUTES field. 

The TYPE field specifies the type of the symbol: ADDR if it is a memory address, 
NUMB if it is a pure number (e.g., as defined by EQU), SEG if it is a relocatable 
segment, and REG if a register. For ADDR and SEG symbols, the segment type is 
added to the type: 

• C — CODE 

• D — DATA 

• X — XDATA 

• I — IDATA 

• B — BIT 

The VALUE field shows the value of the symbol when the assembly was completed. 
For REG symbols, the name of the register is given. For NUMB and ADDR sym- 
bols, their absolute value (or if relocatable, their offset) is given, followed by A 
(absolute) or R (relocatable). For SEG symbols, the segment size is given here. Bit 
address and size are given by the byte part, a period (.), followed by the bit part. The 
scope attribute, if any, is PUB (public) or EXT (external). These are given after the 
VALUE field. 

For the module name symbol, the TYPE and the VALUE fields contain dashes 
( )• 

The ATTRIBUTES field contains an additional piece of information for some sym- 
bols: relocation type for segments, segment name for relocatable symbols. 

If the XREF control is used, then the symbol table listing will also contain all of the 
line numbers of each line of code that the symbol was used. If the value of the sym- 
bol was changed or defined on a line, then that line will have a hash mark (#) follow- 
ing it. The line numbers are displayed in decimal. 
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MC5-51 MACRO ASSEM3LER 



SAMPLE 



SYMBOL TABLE LISTING 



NAME 



T Y 



V A L. U E 



ATTRIBUTES 



ASCBIN. . . . 


c 


ADDR 







EXT 




5INASC. . . . 


C 


ADDR 







EXT 




C3NSTANT_ARE/ 


k c 


SEG 


0056H 






REL=UNIT 


3ATA.AREA . . 


D 


SEG 


ODOCH 






REL=UNIT 


GET_NUM . . 


C 


ADDR 







EXT 




NUMI.MSG. . 


C 


ADDR 


C016H 


R 




SEG=C2NSTANT_AREA 


NJM1 


2 


ADDR 


00D0H 


R 




SEG=DATA_AREA 


NUM2.MSG. - 


. C 


ADDR 


0032H 


R 




SEG=CGNSTANT_AREA 


NUM2. . . . 


. D 


ADDR 


0D04H 


R 




SEG=0ATA_A3EA 


PUT.CRLF. . 


. C 


ADCR 







EXT 




PUT_DATA_STR 


. C 


ADDR 







EXT 




PJT^STRING. 


C 


ADDR 







EXT 




SAMPLE. . . 
















SCON. . . . 


D 


ADDR 


Q09oH 


A 






STACK . . . 


. D 


ADDR 


00C8H 


A 






START . . . 


. C 


AODR 


OOOBH 


A 






SUM.MSG . . 


. C 


ADDR 


004AH 


R 




SEG=CONSTANT_AREA 


SUM .... 


. 


ADDR 


OOOSH 


R 




SEG=OATA_AREA 


TH1 .... 


. 


ADDR 


OOsDH 


A 






TM3D. . . . 


. 


ADDR 


00S9H 


A 






TR1 . . . . 


. B 


ADDR 


00S3H.6 


A 






TYPO.MSG. . 


. C 


ADDR 


OOOOH 


R 




SEG=CQNSTANT.AREA 



REGISTER BANK(S) USED: 0/ TARGET MACHINSCS): 3051 
ASSEMBLY COMPLETE, N3 ERRORS FOUND 

Figure 7-5. Example Symbol Table Listing 



If an inordinate number of symbol references are generated by your program, it may 
be impossible for the assembler to produce a complete XREF table for your entire 
program. In that event, the following warning message is issued at the head of the 
symbol table: 

*** WARNING, XREFS ABANDONED AT LINE Wine 

The XREF listing will be valid up to the specified line. 



Listing File Trailer 

At the end of the listing, the assembler skips two lines and prints a two-line message 
in the following format: 

[NO] REGISTER BANK(S) USED [: r r r r J, TARGET MACHINE(S): 8051 
ASSEMBLY COMPLETE, n ERRORS FOUND (I) 

Where r's are the numbers of the register banks used, and n and 1 are just like the 
console message. 
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This appendix contains a Backus-Naur Form (BNF) grammar for all of the MCS-51 
Assembly Language Constructions. It does not include the grammar for the macro facil- 
ity. (See Chapter 5 and Appendix F.) Although BNF grammar is designed to define only 
syntax, the metasymbols and language breakdown have been selected to show the seman- 
tics of the language. 

To simplify the grammar presented here, we have not defined all of the nuances of the 
language as rigorously as a complete BNF grammar would require. These exceptions are 
listed below. 

There are two types of controls, primary and general. A control line containing 
a primary control must be the first line in a program, or only preceded by other 
control lines. 

Some assembler directives may be used only while certain segment modes are in 
effect (e.g., the bit segment must be active when a DBIT directive is used). 

Operator precedence in expressions has not been defined. 

Symbol typing conventions are not identified. 

In some of the definitions we have used a few words of description, contained in 
double quotes. 

The ASCII string argument to the TITLE and DATE controls must either 
contain balanced parentheses or no parentheses at all. 

There has been no attempt to show the logical blanks (spaces or tabs) that 
separate the fields on a line. 

The symbol NULL is used to show that a meta-symbol may evaluate to nothing. 

Except within character strings, ASM51 makes no distinction between upper 
and lower case characters. All terminal symbols have been shown in upper case, 
but you can use upper or lower case in your source code (including within hex 
constants). 

The NAME statement may be preceded only by a control or empty lines. A 
comment line is considered an empty line. 

List of terms, e.g., <expression list>, unless defined explicitly implies a 
sequence of items separated by commas (,). 

Square brackets are used to enclose optional items. 
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KAssembly Language Program > 
<Statement Ust> 
<End Statement> 
<Statement> 

<Controi Line> 
<Control List> 
<Control> 



<regbank> 
instruction Line> 
<Labef> 

<Comment> 
<Jnstruction> 



:= KStatement Ust> <End Statement> 

:= <Statement><Statement List> | NULL 

:= END <Comment> <CRLF> 

:= <Controf Line> j instruction Line > j 
<Directive Line> 

:= $ <ControJList> <CRLF> 

= <Control> <Control List> | NULL 

= DXTE(<ASCII String >) \DtK«ASCH String>) | 

DEBUG | DE j 

NODEBUG | NODE | 

EJECT | EJ j 

Emon?mHT«Fiiename» j EP«FUename» \ ERRORPRINT | EP | 

NOERRORPRINT | NOEP \ 

GENONLY | GO | 

NOGEN | NOGE | 

GEN | GE | 

INCLUDE«F/te/ja/7?e» | \C{<Fi/ename» J 

LIST | LI | 

NOLIST | NOLI | 

MACRO [{constant)] | MR [«constant>)] 

NOMACRO | NOMR j 

OBJECT<<F/7e/?ame>> \OJ«Fi/ename» \ OBJECT | OJ j 

NOOBJECT | NOOJ | 

PAGING | PI | 

NOPAGING j NOPI j 

PAGELEUGTH(<Constant» \PL{<Constant>) | 

PAGEWIDTH(<Consten/>) | P\N{<Constant>) j 

PRMT(<Filename» \ PR«Filename>) | PRINT j PR | 

NOPRINT | NOPR | 

REGISTERBANK(<re^an/f_//s/>) | RB(<regbank__fist>) | 

NOREGISTERBANK | NORB | 

SAVE j SA | 

RESTORE | RS | 

SYMBOLS | SB | 

NOSYMBOLS | NOSB | 

T\TLE«ASC/I String» | TT«ASCH String» | 

WORKFILES(<£?/-/Ve name>,<Drive name>) j WORKFILES(<0nVe name>) j 

WF{<Drive name>,<Drive name>) \ W?(<Drivename>) | 

XREF | XR | 

NOXREF | NOXR 
= | 1 | 2 | 3 

= <Label> <lnstruction> <CommentXCRLF> 

= <Symbol Name>: | 
NULL 

= \<ASCII Stringy | NULL 

= <Arithmetic instruction > | 
<Multipfication lnstruction> j 
<Logic lnstruction> | 
<Data Move instruction > j 
<Jump instruction > \ 
KSubroutine instruction > \ 
KSpeciai instruction > | 
NULL 
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Arithmetic tnstruction> 
Arithmetic Mnemonio 

^Multiplication lnstruction> 
KLogic instruction > 

Accumulator Logic instwction> 
<Data Address Logic Instruction > 

<Logic Mnemonio 
<Bit Logic Instruction > 

<Data Move Instruction > 



<Bit Move Instruction > 



<Byte Move lnstruction> 



<lndirect Address Move> 



<Data Address Move> 



<Register Move> 



<External Move Instruction > 



<Code Move lnstruction> 

KExchange Instruction > 

<Data Pointer Load> 
<Jump Instruction > 



Arithmetic Mnemonio Accumulator, KByte Source> 

ADD | 
ADDC \ 
SUBB 

DIV AB | 
MULAB 

: Accumulator Logic Instruction > | 
<Data Address Logic lnstruction> | 
<Bit Logic Instruction > 

<Logic Mnemonio Accumulator , KByte Source> 

■■ <Logic Mnemonio Oata Address>,Accumulator> | 
<Logic Mnemonic > Oata Address >,<lmmediate Data > 

ANL | 
ORL | 
XRL 

* M*LC,<BitAddress> | 
ANL C,l<Bit Address> | 
ORLC,<BitAddress> \ * 
ORL C,KBit Address > 

■■ <Bit Move lnstruction> | 
<Byte Move Instruction > \ 
KExtemal Move Instruction > \ 
<Code Move lnstruction> | 
<Exchange lnstruction> | 
<Data Pointer Load> 

■■ MOV C,<BitAddress> \ 
MOV <Bit Address>,C 

■■ MOV <Accumulator>, KByte Source> j 
Klndirect Address Move> \ 
KData Address Move> \ 
KBegister Move> 

■ MOV Klndirect Address>,KAccumutator> | 
MOV Klndirect Address>,Klmmediate Data > j 
MOV Klndirect Address > , KData A ddress > 

■- MOV KData Address>,KAccumulator> \ 
MOV KData Address>, KByte Source > 

■■ MOV KRegister>,KAccumulator> \ 
MOV KRegister> immediate Data> | 
MOV KRegister>, KData Address > j 

-■ MOVX KAccumulator>, Klndirect Address> \ 
MOVX Klndirect Address> ,KAcCumulator> | 
MOVX KAccumutator>, @DPTR | 
MOVX @DPJR,KAccumulator> 

■- MOVC KAccumulator>,@ A + PC j 
MOVC KAccumulator>,@ A + DPTR 

-- XCHD KAccumulator>, Klndirect Address> j 
XCH KAccumulator>, KByte Destination> 

■■ MOV DPTR,Klmmediate Data> 

-- KDecrement Jump> | 
KCompare Jump> \ 
KTest Jump> \ 
KAfways Jump> 
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<Decrement Jump > 
<Compare Jump> 

<Test Jump> 



Always Jump> 



<Subroutine lnstruction> 



<Call Instruction > 



<Return Instruction > 



<Special Instruction > 



increment Instruction > 



<Decrement Instruction > 



■■ DJMZ <Register>,<CodeAddress> \ 
DJNZ <Data Address>,<Code Address> 

■■ CJHEAccumulator>,<lmmediate Data,<Code Address > j 
CJNE <Accumulator>,<DataAddress>,<CodeAddress> | 
CJN E <lndirect Address>,<lmmediate Data >,<Code Address > 
CJNE <Register>, immediate Data>,<Code Address > 

JC <Code Address> \ 

JNC <Cocte Address > \ 

JKCode Address> \ 

JHKCodeAddress> | 

J B <Bit Address >,<Code Address > | 

JBC <Bit Address>,<Code Address > | 

JNB <Bit Address >,<Code Address> 

S J M P <Code Address > | 
AJMP <Code Address> \ 
LJ M P <Code Address > \ 
J M P <Code A ddress > | 
JMP@A + DPTR 

= <Call lnstruction> j 
<Return Instruction > 

■■ ACALL <Code Address > \ 
LC ALL <Code Address > | 
CALL <Code Add res s> 

■ RET | 
RETI 

; increment lnstruction> | 
<Decrement lnstruction> | 
Accumulator Modify lnstruction> \ 
<Bit Modify Instruction > \ 
<Stack Instruction > | 
NOP 

INC <Accumulator> \ 

INC DPTR | 

INC KByte Destination > 

DEC <Accumu/ator> \ 
DEC KByte Destination > 



Accumulator Modify lnstruction> 


: '.- Accumulator Modify Mnemonic > Accumulator 


Accumulator Modify Mnemonic> 


::= CLR | 




CPL | 




DA | 




SWAP j 




RL | 




RR | 




RLC j 




RRC 


<Bit Modify Instruction > 


: := <Bit Modify Mnemonic > <Bit Destination > 


<Bit Modify Mnemonic> 


::= SETB | 




CLR | 




CPL 



<Stack Instruction > 



KDirective Line> 



POP <Data Address> \ 
PUSH <Data Address> 

KDirective Statement><CommentXCRLF> 
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<Directive Statement> 



<Org Statement> 

<Using Statement > 

<Symbol Definition Statement> 



<Segmenttype> 
<Relocatability> 

<External definition statement> 
<external definition > 
<Usage type> 

<Pub!ic definition statement> 
<Name statement> 
KSegment Select Statement> 
<Absolute segment select> 
<Absseg> 
<Base address > 
<Relocatable segment select> 
<Space Allocation Statement> 

<Memory Initialization Statement> 



<Filename> 
<Drive name> 
<ASCII String> 
<Constant> 

<DecimalDigit> 
<CRLF> 



■■ <Org Statement \ 
<Using Statement> 
<Symbol Definition Statement> | 
KSegment Select Statement> \ 
<LabelXSpace Allocation Statement \ 
<LabelXMemory Initialization Statement> 

ORG <Expression> 

USING <Expressions> 

<Symbol> EQU <Expression> | 
<Symbol>EQ\J<SymbolRegister> \ 
<Symbol> SET <Expression> \ 
<Symbol> SET <Symboi Register> \ 
<Symbol>DkTk<Expression> \ 
<Symbol>XDATk<Expression> \ 
<Symbol> BIT <Bit Address> \ 

<Symbol> CODE <expression> \ 

<Symbol> IDATA <expression> | 

<Symbol> SEGMENT <segment types><relocatability> \ 

KExternal definition statement> \ 

<Public definition statement \ 

<NAME statement \ 

::= CODE j XDATA | IDATA | BIT | DATA 

:= UNIT | PAGE | INPAGE | INBLOCK | BITADDRESSABLE | 
NULL 

= EXTRN <External definition list> 

■■ <Usage type> (<symbollist>) 

■ <Segmenttype> | NUMBER 

= PUBLIC <symbollist> 

HAME<symbol> 
■■ <absolute segment select> \ relocatable segment seJect> 

<abs seg > <base address > 
■■ CSEG | DSEG | BSEG | XSEG | ISEG 

AT <expression> | NULL 

: RSEG <symbol> 

DS KExpression > \ 
DBIT <Expression> 

■■ DB <Expression List> 

"ASCII character strings, as items in a DB expression list, 
may be arbitrarily long." 
DW <Expression List> 

"ASCII character strings, as items in a DW expression list, 
must be no more than two characters long." 

= "ISIS-II Filename" 

: "ISIS-II Drive Identifier" 

: "Any Printable ASCII Character" 

= <Decimal Dig it > j 
<Decimal Digit><Constant> 

=0|1|2|3|4|5|6|7|8|9 

= "ASCII Carriage Return Line Feed Pair" 
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KByte Source> 



<lndirect Address > 

<Data Address> 
<lm mediate Data> 
<Register> 

KByte Destination > 

KAccumulator> 
KSymbof Register> 
KSymbol> 
KAIphabet> 



KSpecial Char> 
KAtphanumeric List> 
KAIphanumeriO 

KBit Destination> 

<Bit Address> 

KCode Address> 
KExpression List> 

KExpression> 



KOperator> 



KNumber> 



= Klndirect Address> | 
KData Address> j 
Kim mediate Data> \ 
KRegister> 

■■ @R0 | @R1 | 
@KSymbol> 

■■ KExpression > 

■■ *KExpression> 

RO | R1 | R2 | R3 | R4 | R5 | R6 | R7 | 
KSymbo/> 

■■ Klndirect Address > | 
KData Add ress> \ 
KRegister> 

A | KSymbol> 

KAccumulator> \ KRegister> 

KAlphabetXAfphanumeric List> \ <Special CharXAIphanumeric List> 

A | B I C j D | E | F | G | H | I | 
J|K|L|M|N|0|P|Q|R| 
S | T | U | V | W | X | Y | Z 
a I b | c | d | e | f j g | h | i | 
j I k | I | m | n | o | p | q | r | 
s |.t. | u | v | w | x | y | z | 

::= _ "Underscore" j 
? 

:= KAIphanumeric>KAIphanumeric List> | 
NULL 

:= KAIphabet> | 
KDecimal Digit> J 
KSpecial Char> 

:=C| 

KBit Address> 

:= KExpression > | 

KExpression >. KExpression > 

:= KExpression> 

:= KExpression> \ 

KExpression>, KExpression List> 

:= KSymboO \ 
KNumber> \ 

KExpression >KOperator>KExpression > | 
{KExpression>) \ 
+ KExpression> \ 
-KExpression > \ 
HIGH KExpression > \ 
LOW KExpression> 

:= + I - | / j MOD | SHL | SHR j 
EQ | = | NE | <> | LT | < | LE | 
<= j GT j > j GE | >= | AND | OR | XOR 

:= KHex Number> | 
KDecimal Number> \ 
KOctal ' Number > \ 
KBinary Number> 
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<Hex Number> 
<Hex Digit String > 

<HexDigit> 

<Decimal Number> 

<Decimal Digit String > 

<Octal Number> 

<Octai Digit Stringy 

<OctalDigit> 
<Binary Number> 
<Binary Digit String > 

KBinary Digit> 



■■ <Decimal DigitXHex Digit String > H 

= <Hex DigitXHex Digit String > \ 
NULL 

| 1 |2 |3 |4 |5 |6 |7 | 
8|9jA|B|C|D|E|F 

<Decimal Digit String > D j 
<Decimal Digit String > 

<Decimal Digit > \ 

<Decimaf DigitXDecimal Digit String > 

<Octal Digit Stringy O \ 
<Octal Digit String > 

= <Octal Digit > \ 
<Octal DigitXOctal Digit String > 

0| 1 | 2| 3| 4| 5 | 6 | 7 

<Binary Digit String > B 

<Binary Digit> | 

<Binary DigitXBinary Digit String > 

0|1 
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This appendix contains two tables: the first identifies all of the 805 Ts instructions in 
alphabetical order; the second table lists the instructions according to their hexa- 
decimal opcodes and lists the assembly language instructions that produced that 
opcode. 

The alphabetical listing also includes documentation of the bit pattern, flags 
affected, number of machine cycles per execution and a description of the instruc- 
tions operation and function. The list below defines the conventions used to identify 
operation and bit patterns. 

Abbreviations and Notations Used 



A 


Accumulator 


AB 


Register Pair 


B 


Multiplication Register 


bit address 


8051 bit address 


page address 


11-bit code address within 2K page 


relative offset 


8-bit 2's complement offset 


C 


Carry Flag 


code address 


Absolute code address 


data 


Immediate data 


data address 


On-chip 8-bit RAM address 


DPTR 


Data pointer 


PC 


Program Counter 


Rr 


Register (r=0-7) 


SP 


Stack pointer 


high 


High order byte 


low 


Low order byte 


H 


Bits i through j 


.n 


Bit n 


aaa aaaaaaaa 


Absolute page address encoded in instruction and operand byte 


bbbbbbbb 


Bit address encoded in operand byte 


dddddddd 


Immediate data encoded in operand byte 


IIIIIIH 


One byte of a 16-bit address encoded in operand byte 


mm mm mm mm 


Data address encoded in operand byte 


oooooooo 


Relative offset encoded in operand byte 


r or rrr 


Register identifier encoded in operand byte 


AND 


Logical AND 


NOT 


Logical complement 


OR 


Logical OR 


XOR 


Logical exclusive OR 


+ 


Plus 


- 


Minus 


/ 


Divide 


* 


Multiply 


(X) 


The contents of X 


«x» 


The memory location addressed by (X) (The contents of X) 


= 


Is equal to 


<> 


Is not equal to 


< 


Is less than 


> 


Is greater than 


*~ 


is replaced by 
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Table B-l . Instruction Set Summary 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


ACALL codeaddr 

(PC) - (PC) + 2 

(SP) - (SP) + 1 

((SP))^-(PC)/ow 

(SP)-(SP) + 1 

((SP))^ (PC) high 

(PC) 0-10 «- page address 


2 


a a a 1 1 
aaaaaaaa 




Push PC on stack, 
and replace low 
order 11 bits with 
low order 11 bits of 
code address. 


ADD A,#ctete 

(A) - (A) + data 




10 10 
dddddd dd 


P OV AC C 


Add immediate 
data to A 


ADD A,@Rr 

(A) - (A) + ((Rr» 




1 1 1 r 


P OV AC C 


Add contents of 
indirect address to 
A 


ADD A,Rr 

<A)-(A) + (Rr) 




1 1 r r r 


P OV AC C 


Add register to A 


ADD A, data ad dr 

(A) «-(A) + {data address) 




10 10 1 
mmmmrnmmm 


P OV AC C 


Add contents of 
data address to A 


ADDC A,#tfate 

(A) - (A) + (C) + data 




110 10 
dddddddd 


P OV AC C 


Add C and 
immediate data to 
A 


ADDC A,@Rr 

(A)«-(A) + (C) + ((Rr» 




1 1 1 1 r 


P OV AC C 


Add C and contents 
of indirect address 
to A 


ADDC A,Rr 

(A)-(A) + (C) + (Rr) 




1 1 1 r r r 


P OV AC C 


Add C and register 
to A 


ADDC A,dataaddr 

(A) - (A) + (C) + (data address) 




110 10 1 
mmmmmrnmm 


P OV AC C 


Add Cand contents 
of data address to 
A 


AJMP codeaddr 

(PC) 0-10 *- coote address 


2 


a a a 1 
aaaaaaaa 




Replace low order 
11 bits of PC with 
low order 11 bits 
code address 


ANL A,#ctete 

(A) -(A) AND data 


1 


10 10 100 
dddddddd 


P 


Logical AND 
immediate data to 
A 


ANL A,@Rr 

<A)-(A)AND«Rr)) 


1 


1 1 1 1 r 


P 


Logical AND 
contents of indirect 
address to A 


ANL A.Rr 

(A) «- (A) AND (Rr) 


1 


1 1 1 r r r 


P 


Logical AND 
register to A 


ANL Mataaddr 

(A) - (A) AND (ctete address) 


1 


10 10 10 1 
mmmmmrnmm 


P 


Logical ANd 
contents of data 
address to A 


ANL Cbitaddr 

(C) - (C) AND (bit address) 


2 


10 10 
bbbbbbbb 


c 


Logical AND bit to 
C 


ANL CJbitaddr 

(C) *- (C) AND HOT (bit address) 


2 


10 110 
bbbbbbbb 


C 


Logical AND 
complement of bit 
to C 


ANL data addr ,#data 
(data address) *- 

(data address ) AN D date 


2 


10 10 11 
mmmmmrnmm 
dddddddd 




Logical AND 
immediate data to 
contents of data 
address 


ANL dataaddrA 

(data address) <*- 

(data address ) AN D A 


1 


10 10 10 
mmmmmrnmm 




Logical AND A to 
contents of data 
address 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


CJNE @Rr,#data, code addr 
(PC) - (PC) + 3 
IF ((Rr))<> data 
THEN 

(PC) *- (PC) + relative offset 
\F((Rr))<data 

THEN (C) - 1 

ELSE (C) - 


2 


1 1 1 1 1 r 
dddddddd 

00000000 


C 


If immediate data 
and contents of 
indirect address 
are not equal, jump 
to code address 


CJNE k,*data, code addr 
(PC) «- (PC) + 3 
IF(A)Ocfete 
THEN 

(PC) *- (PC) + relative offset 
\F(A)<data 

THEN(C)-1 

ELSE(C)*-0 


2 


10 110 10 
dddddddd 

00000000 


C 


If immediate data 
and A are not 
equal, jump to code 
address 


C J N E A ,data addr ,code addr 
(PC) - (PC) + 3 
IF (A) <> (data address) 
THEN 

(PC) *- (PC) + relative offset 
IF (A) < (data address) 

THEN(C)*-1 

ELSE (C) *- 


2 


10 110 10 1 
rnrnrnrnrrimmm 

00000000 


C 


If contents of data 
address and A are 
not equal, jump to 
code address 


CJNE Rr^ata, code addr 
(PC) - (PC) + 3 
\F(Rr)Odata 
THEN 

(PC) *- (PC) + relative offset 
\F(W)<data 

THEN(C)-1 

ELSE(C)-0 


2 


1 1 1 1 r r r 
dddddddd 

00000000 


C 


If immediate data 
and register are not 
equal, jump to code 
address 


CLR A 

(A)-0 




1110 10 


P 


Set A to zero (0) 


CLR C 

<C)-0 




110 11 


C 


Set C to zero (0) 


CLR bit addr 

(bit address) *- 




110 10 
bbbbbbbb 




Set bit to zero (0) 


CPL A 

(A) - NOT (A) 




11110 10 


P 


Complements each 
bit in A 


CPL C 

(C) - NOT (C) 




10 110 11 


c 


Complement C 


CPL bit addr 

(bit address) «- 

NOT (bit address) 




10 110 10 
bbbbbbbb 




Complement bit 


DA A 

(See description in Chapter 3) 




110 10 10 


P c 


Adjust A after a 
BCD add 


DEC @Rr 

<(Rr))-((Rr))-1 




1 1 1 r 




Decrement 
contents of indirect 
address 


DEC A 

(A)-(A)-1 




10 10 


p 


Decrement A 


DEC Rr 

(Rr)-(Rr)-1 




1 1 r r r 




Decrement register 


DEC data addr 

(data address) — 

(data address ) - 1 




10 10 1 
rnrnrnmrnrniTim 




Decrement 
contents of data 
address 


DIV AB 

(AB)-(A)MB) 




10 10 


P ov c 


Divide A by B 

(multiplication 

register) 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


DJNZ Rr, code add 'r 

(PC) «- (PC) + 2 
<Rr)-(Rr)-1 
IF(Rr)<>0 
THEN 
(PC) *- (PC) + relative offset 


2 


1 1 1 1 r r r 






Decrement 
register, if not zero 
(0), then jump to 
code address 


D J N Z da ta addr ,code addr 
(PC) - (PC) + 3 
{data address) *- 

{data address) -1 
IF {da ta address) = 
THEN 
(PC) *- (PC) + relative offset 


2 


110 10 10 1 
rnrnrnrnnimmm 

00000000 




Decrement data 
address, if zero (0), 
then jump to code 
address 


INC @Rr 

((Rr))-((R0) + 1 


1 


1 1 r 




increment contents 
of indirect address 


INC A 

(A) - (A) + 1 


1 


000-00100 


P 


Increment A 


INC DPTR 

(DPTR) -(DPTR) + 1 


1 


10 10 11 




Increment 16-bit 
data pointer 


INC Rr 

((R) *- (Rr) + 1 ■ 


1 


1 r r r 




Increment register 


INC data addr 

{data address) +- 

{data address) + 1 


2 


10 1 
mmmmmmmm 




Increment contents 
of data address 


JB bit addr, code addr 
(PC) - (PC) + 3 
IF {bit address) = 1 
THEN 
(PC) - (PC) + relative offset 


2 


10 
bbbbbbbb 

00000000 




If bit is one, n jump 
to code address 


JBC bit addr, code addr 
(PC) - (PC) + 3 
IF {bit address) = 1 
THEN 

(PC) - (PC) + relative offset 

{bit address) — 


2 


10 
bbbbbbbb 

00000000 




If bit is one, n clear 
bit and jump to 
code address 


JC code addr 

(PC) - (PC) + 2 
IF(C) = 1 
THEN 
(PC) - (PC) + relative offset 


2 


10 

00000000 




If C is one, then 
jump to code 
address 


JMP @A + DPTR 

(PC)-(A) + (DPTR) 


2 


1110 11 




Add A to data 
pointer and jump to 
that code address 


JNB bit addr, code addr 
(PC) -(PC) + 3 
\F {bit address) = 
THEN 
(PC) *- (PC) + re/a//Ve offeef 


2 


110 
bbbbbbbb 

0000000 




If bit is zero, n jump 
to code address 


JNC code addr 

(PC) + (PC) + 2 
IF(C) = 
THEN 
(PC) *- (PC) + relative offset 


2 


10 10 

00000000 




If C is zero (0), n 
jump to code 
address 


JNZ code addr 

(PC) -(PC) + 2 
IF(A)<>0 
THEN 
(PC) *- (PC) + relative offset 


2 


1110 

00000000 




If A is not zero (0), n 
jump to code 
address 
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Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


JZ codeaddr 

(PC) - (PC) + 2 
IF(A) = 
THEN 
(PC) *- (PC) + relative offset 


2 


110 
00000000 




If A is zero (0), then 
jump to code 
address 


LCALL codeaddr 

(PC) - (PC) + 3 
(SP) - (SP) + 1 
((SP))*-((PC))/oi/f 
(SP)-(SP) + 1 
((SP))- (PC) high 
(PC) — code address 


2 


10 10 

1 I I I I I I l f 
I I I I I I I l f 




Push PC on stack 
and replace entire 
PC value with code 
address 


LJMP codeaddr 

(PC) — code address 


2 


10 

1 I I I I I I I 1 
11111111* 




Jump to code 
address 


MOV @Rr,#data 

((Rr))^data 


1 


1 1 1 1 1 r 
dddddddd 




Move immediate 
data to indirect 
address 


MOV @Rr,A 

«Rr))-(A) 


1 


1 1 1 1 1 1 r 




Move A to indirect 
address 


MOV @Rr,dataaddr 

((Rr)) — (data address) 


2 


1 1 1 1 r 
mm mm mm mm 




Move contents of 
data address to 
indirect address 


MOV A,#ctete 

(A)*- date 


1 


1110 10 
dddddddd 


P 


Move immediate 
data to A 


MOV A,@Rr 

(A)-((Rr)) 


1 


1 1 1 1 1 r 


P 


Move contents of 
indirect address to 
A 


MOV A,Rr 

(A)-(Rr) 


1 


1 1 1 1 r r r 


P 


Move register to A 


MOV A,dataaddr 

(k) *- (data address) 


1 


1110 10 1 
mmmmmmmm 


P 


Move contents of 
data address to A 


MOV CMaddr 

(C) ^ (bit address) 


1 


10 10 10 
bbbbbbbb 


C 


Move bit to C 


MOV DPTR,#date 

(DPTR)-tfate 


2 


10 10 
dddddddd 1 
dddddddd* 




Move two bytes of 
immediate data 
pointer 


MOV Rr,#tfate 

(Rr) - data 


1 


1 1 1 1 r r r 
dddddddd 




Move immediate 
data to register 


MOV Rr,A 

(Rr)-(A) 


1 


1 1 1 1 1 r r r 




Move A to register 


MOV Rr,dataaddr 

(Rr) *- (data address) 


2 


1 1 1 r r r 
mmmmmmmm 




Move contents of 
data address to 
register 


MOV bitaddr,C 

(bit address) -(C) 


2 


10 10 10 
bbbbbbbb 




Move C to bit 


MOV dataaddr,*data 

(data address ) «- data 


2 


1110 10 1 
mmmmmmmm 
dddddddd 




Move immediate 
data to data 
address 


MOV dataaddr,@Rr 

(data address) *- ((Rr)) 


2 


1 1 1 r 
mmmmmmmm 




Move contents of 
indirect address to 
data address 


MOV dataaddr,k 

(data address ) *- (A) 


1 


11110 10 1 
mmmmmmmm 




Move A to data 
address 


t The high order byte of the 16-bit operand is in the first byte following the opcode. The low order byte is 
in the second byte following the opcode. 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


MOV data addr,Rr 

(da ta address ) — ( Rr ) 


2 


1 1 r r r 
mm mm mm mm 




Move register to 
data address 


MOV data addrl ,data addr2 
(daiaaddressl)*- 

(data address2) 


2 


10 10 1 

mmmmmmmm* 

mmmmmmmm* 




Move contents of 
second data 
address to first 
data address 


MOVC A,@A + DPTR 

(A) - ((A) + (DPTR)) 


2 


10 10 11 


P 


Add A to DPTR and 
move contents of 
that code address 
with A 


MOVC A,@A + PC 

(A) - ((A) + (PC)) 


2 


10 11 


P 


Add A to PC and 
move contents of 
that code address 
with A 


MOVX @DPTR,A 

((DPTR)) -(A) 


2 


11110 000 




Move A to external 
data location 
addressed by 
DPTR 


MOVX @Rr,A 

((Rr)) - (A) 


2 


1 1 1 1 1 r 




Move A to external 
data location 
addressed by 
register 


MOVX A,@DPTR 

(A) -((DPTR)) 


2 


1110 


P 


Move contents of 
external data loca- 
tion addressed by 
DPTR to A 


MOVX A,@Rr 

(A)*-((Rr)) 


2 


1 1 1 1 r 


P 


Move contents of 
external data loca- 
tion addressed by 
register to A 


MUL AB 

(AB) - (A) * (B) 


4 


10 10 10 


P OV c 


Multiply A by B 
(multiplication 
register) 


NOP 


1 







Do nothing 


ORL A,#ctefa 

(A)-(A)ORctete 


1 


10 10 
dddddddd 


p 


Logical OR 
immediate data to 
A 


ORL A,@Rr 

(A) - (A) OR ((Rr)) 


1 


1 1 1 r 


p 


Logical OR 
contents of indirect 
address to A 


ORL A,Rr 

(A) - (A) OR (Rr) 


1 


1 1 r r r 


p 


Logical OR register 
to A * 


ORL A,dataaddr 

(A) - (A) OR (data address ) 


1 


1 00 1 1 
mmmmmmmm 


p 


Logical OR 
contents of data 
address to A 


ORL Cbitaddr 

(C) -(C) OR (bit address) 


2 


1110 10 
bbbbbbbb 


c 


Logical OR bit to C 


ORL CJbitaddr 

(C) *- (C) OR NOT (bit address) 


2 


10 10 
bbbbbbbb 


c 


Logical OR 
complement of bit 
toC 


ORL data addr ,#data 

(data address) *- 

(data address ) OR data 


2 


10 11 
mmmmmmmm 
dddddddd 




Logical OR 
immediate data to 
data address 


ORL dataaddr,A 

(data address) *- 

(data address) OR A 


1 


10 0010 
mmmmmmmm 




Logical OR A to 
data address 


* The source data address (second data address) is encoded in the first byte following the opcode. The 
destination data address is encoded in the second byte following the opcode. 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OV AC C 


Function 


POP data ad dr 

{data address) «-((SP)) 
(SP)-(SP)-1 


2 


110 10 
rnrnrnmmmmm 




Place top of stack 
at data address and 
decrement SP 


PUSH dataaddr 

(SP)-(SP) + 1 

((SP)) ^ {data address) 


2 


110 
mmmmmmmm 




Increment SP and 
place contents of 
data address at top 
of stack 


RET 

{PC) high +-{{$P)) 
(SP)-(SP)-1 
{PC) low *-{{SP)) 
(SP)-(SP)-1 


2 


10 10 




Return from 
subroutine call 


RETI 

(PC) high -((SP)) 
(SP)*-(SP)-1 
(PC)/oiv-((SP)) 
(SP)-(SP)-1 


2 


110 10 




Return from 
interrupt routine 


RL A 

(See description in Chapter 3) 


1 


10 11 




Rotate A left one 
position 


RLC A 

(See description in Chapter 3) 


1 


110 11 


P C 


Rotate A through C 
left one position 


RR A 

(See description in Chapter 3) 


1 


11 




Rotate A right one 
position 


RRC A 

(See description in Chapter 3) 


1 


10 11 


P c 


Rotate A through C 
right one position 


SETB C 

(C)-1 


1 


110 10 11 


c 


Set C to one (1) 


SETB bitaddr 

{bit address) «-1 


1 


110 10 10 
bbbbbbbb 




Set bit to one (1) 


SJMP code add r 

(PC) - (PC) + relative offset 


2 


10 

00000000 




Jump to code 
address 


SUBB Mdata 

(A)-(A)-(C)-tfate 


1 


10 10 10 
dddddddd 


P OV AC C 


Subtract immediate 
data from A 


SUBB A,@Rr 

(A) - (A) - (C) - ((Rr)) 


1 


1 1 1 1 r 


P OV AC C 


Subtract contents 
of indirect address 
from A 


SUBB A,Rr 

(A)-(A)-(C)-(Rr) 


1 


1 1 1 r r r 


P OV AC C 


Subtract register 
from A 


SUBB A,dataaddr 

(A) - (A) - (C) - {data address) 


1 


10 10 10 1 
mmmmmmmm 


P OV AC C 


Subtract contents 
of data address 
from A 


SWAP A 

(See description in Chapter 3) 


1 


110 10 




Exchange low 
order nibble with 
high order nibble in 
A 


XCH A,@Rr 

temp *- ((Rr)) 
((Rr)) - (A) 

(A) *- temp 


1 


1 1 1 1 r 


P 


Move A to indirect 
address and vice 
versa 


XCH A,Rr 

temp — (Rr) 
(Rr)-(A) 
{A) ^ temp 


1 


1 1 1 r r r 


P 


Move A to register 
and vice versa 


XCH A,dataaddr 

temp *- {data address) 
{data address ) *- (A) 

(A) *- temp 


1 


110 10 1 
mmmmmmmm 


P 


Move A to data 
address and vice 
versa 
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Table B-l . Instruction Set Summary (Cont'd.) 



Mnemonic 
Operation 


Cycles 


Binary 
Code 


Flags 
P OVACC 


Function 


XCHD A,@Rr 

temp *- ((Rr)) 0-3 
((Rr)) 0-3 <- (A) 0-3 
(A) 0-3 *- temp 


1 


1 1 1 1 1 r 


P 


Move low order of 
A to low order 
nibble of indirect 
address and vice 
versa 


XRL A,#etete 

(A)*- (A) XOR data 


1 


110 10 
dddddddd 


P 


Logical exclusive 
OR immediate data 
to A 


XRL A,@Rr 

(A) - (A) XOR ((Rr)) 


1 


1 1 1 1 r 


P 


Logical exclusive 
OR contents of 
indirect address to 
A 


XRL A,Rr 

(A) <- (A) XOR (Rr) 


1 


1 1 1 r r r 


P 


Logical exclusive 
OR register to A 


XRL A,dataaddr 

(A) - (A) XOR (data address) 


1 


110 10 1 
rnrnnrirnrnrnrnrn 


P 


Logical exclusive 
OR contents of data 
address to A 


XRL dataaddr,#data 

(data address) *- 

(data address ) XOR data 


2 


110 11 
mmmrnmmmm 
dddddddd 




Logical exclusive 
OR immediate data 
to data address 


XRL dataaddr,k 

{data address) *- 

(data address) XOR A 


1 


110 10 
mmrnrnmrnmrn 




Logical exclusive 
OR A to data 
address 
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Table B-2. Instruction Opcodes in Hexadecimal 



Hex 
Code 


Number 
of Bytes 


Mnemonic 


Operands 


00 


1 


NOP 




01 


2 


AJMP 


code addr 


02 


3 


LJMP 


codeaddr 


03 




RR 


A 


04 




INC 


A 


05 


2 


INC 


data addr 


06 




INC 


@R0 


07 




INC 


@R1 


08 




INC 


R0 


09 




INC 


R1 


0A 




INC 


R2 


0B 




INC 


R3 


OC 




INC 


R4 


0D 




INC 


R5 


0E 




INC 


R6 


OF 




INC 


R7 


10 


3 


JBC 


bit addr, code addr 


11 


2 


ACALL 


code addr 


12 


3 


LCALL 


code addr 


13 


1 


RRC 


A 


14 


1 


DEC 


A 


15 


2 


DEC 


data addr 


16 


1 


DEC 


@R0 


17 


1 


DEC 


@R1 


18 


1 


DEC 


R0 


19 


1 


DEC 


R1 


1A 


1 


DEC 


R2 


1B 


1 


DEC 


R3 


1C 


1 


DEC 


R4 


1D 


1 


DEC 


R5 


1E 


1 


DEC 


R6 


1F 


1 


DEC 


R7 


20 


3 


JB 


bit addr, code addr 


21 


2 


AJMP 


code addr 


22 


1 


RET 




23 


1 


RL 


A 


24 


2 


ADD 


A,#ctete 


25 


2 


ADD 


k,data addr 


26 


1 


ADD 


A,@R0 


27 


1 


ADD 


A,@R1 


28 


1 


ADD 


A,R0 


29 


1 


ADD 


A,R1 


2A 


1 


ADD 


A,R2 


2B 


1 


ADD 


A,R3 


2C 


1 


ADD 


A,R4 


2D 


1 


ADD 


A,R5 


2E 


1 


ADD 


A,R6 


2F 


1 


ADD 


A,R7 


30 


3 


JNB 


bit addr, code addr 


31 


2 


ACALL 


code addr 


32 


1 


RETI 




33 


1 


RLC 


A 


34 


2 


ADDC 


Afdata 


35 


2 


ADDC 


A,data addr 


36 


1 


ADDC 


A,@R0 


37 


1 


ADDC 


A,@R1 


38 


1 


ADDC 


A,R0 


39 


1 


ADDC 


A,R1 


3A 


1 


ADDC 


A,R2 


3B 


1 


ADDC 


A,R3 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 


Hex 
Code 


Number 
of Bytes 


Mnemonic 


Operands 


3C 


1 


ADDC 


A,R4 


3D 


1 


ADDC 


A,R5 


3E 


1 


ADDC 


A,R7 


3F 


1 


ADDC 


A,R7 


40 


2 


JC 


code addr 


41 


2 


AJMP 


code addr 


42 


2 


ORL 


data addr ,A 


43 


3 


ORL 


data addr ,#data 


44 


2 


ORL 


Afdata 


45 


2 


ORL 


A,data addr 


46 




ORL 


A,@R0 


47 




ORL 


A,@R1 


48 




ORL 


A,R0 


49 




ORL 


A,R1 


4A 




ORL 


A,R2 


4B 




ORL 


A,R3 


4C 




ORL 


A,R4 


4D 




ORL 


A,R5 


4E 




ORL 


A,R6 


4F 




ORL 


A,R7 


50 


2 


JNC 


code addr 


51 


2 


ACALL 


code addr 


52 


2 


ANL 


data addr, A 


53 


3 


ANL 


data addr,#data 


54 


2 


ANL 


AJdata 


55 


2 


ANL 


A, data addr 


56 




ANL 


A,@R0 


57 




ANL 


A,@R1 


58 




ANL 


A,R0 


59 




ANL 


A,R1 


5A 




ANL 


A,R2 


5B 




ANL 


A,R3 


5C 




ANL 


A,R4 


5D 




ANL 


A,R5 


5E 




ANL 


A,R6 


5F 




ANL 


A,R7 


60 


2 


JZ 


code addr 


61 


2 


AJMP 


code addr 


62 


2 


XRL 


data addr, A 


63 


3 


XRL 


data addr$data 


64 


2 


XRL 


A$data 


65 


2 


XRL 


A,data addr 


66 




XRL 


A,@R0 


67 




XRL 


A,@R1 


68 




XRL 


A,R0 


69 




XRL 


A,R1 


6A 




XRL 


A,R2 


6B 




XRL 


A,R3 


6C 




XRL 


A,R4 


6D 




XRL 


A,R5 


6E 




XRL 


A,R6 


6F 




XRL 


A,R7 


70 


2 


JNZ 


code addr 


71 


2 


ACALL 


code addr 


72 


2 


ORL 


Cbitaddr 


73 


1 


JMP 


@A + DPTR 


74 


2 


MOV 


A$data 


75 


3 


MOV 


data addr Mata 


76 


2 


MOV 


@R0,#dafa 


77 


2 


MOV 


@ R1, §data 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 



Hex 


Number 






Code 


of Bytes 


Mnemonic 


Operands 


78 


2 


MOV 


ROfdata 


79 


2 


MOV 


R1 ,*data 


7A 


2 


MOV 


R2,#data 


7B 


2 


MOV 


R3,#data 


7C 


2 


MOV 


R4, tdata 


7D 


2 


MOV 


R5,#tfate 


7E 


2 


MOV 


R6,#tfate 


7F 


2 


MOV 


R7,#ctete 


80 


2 


SJMP 


code addr 


81 


2 


AJMP 


code addr 


82 


2 


ANL 


Z, bit addr 


83 


1 


MOVC 


A,@A + PC 


84 


1 


DIV 


AB 


85 


3 


MOV 


data addr, data addr 


86 


2 


MOV 


data addr, @R0 


87 


2 


MOV 


data addr, @R1 


88 


2 


MOV 


data addr, HO 


89 


2 


MOV 


data add r,R1 


8A 


2 


MOV 


data addr, Kl 


8B 


2 


MOV 


data addr, R3 


8C 


2 


MOV 


data addr, Rb 


8D 


2 


MOV 


data addr ,R5 


8E 


2 


MOV 


data addr, R6 


8F 


2 


MOV 


data addr, Kl 


90 


3 


MOV 


DPTR,#ctefa 


91 


2 


ACALL 


code addr 


92 


2 


MOV 


bit addr, C 


93 


1 


MOVC 


A,@A + DPTR 


94 


2 


SUBB 


A,#data 


95 


2 


SUBB 


k,data addr 


96 




SUBB 


A,@R0 


97 




SUBB 


A,@R1 


98 




SUBB 


A,R0 


99 




SUBB 


A,R1 


9A 




SUBB 


A,R2 


9B 




SUBB 


A,R3 


9C 




SUBB 


A,R4 


9D 




SUBB 


A,R5 


9E 




SUBB 


A,R6 


9F 




SUBB 


A,R7 


A0 


2 


ORL 


C,l bit addr 


A1 


2 


AJMP 


code addr 


A2 


2 


MOV 


Cbitaddr 


A3 


1 


INC 


DPTR 


A4 


1 


MUL 


AB 


A5 




reserved 




A6 


2 


MOV 


@R0,dataaddr 


A7 


2 


MOV 


@R1, data addr 


A8 


2 


MOV 


R0,data addr 


A9 


2 


MOV 


R1, data addr 


AA 


2 


MOV 


R2,data addr 


AB 


2 


MOV 


R3,dataaddr 


AC 


2 


MOV 


RA,dataaddr 


AD 


2 


MOV 


R5,dataaddr 


AE 


2 


MOV 


R6,dafa addr 


AF 


2 


MOV 


R7,data addr 


BO 


2 


ANL 


CJ bit addr 


B1 


2 


ACALL 


code addr 


B2 


2 


CPL 


bit addr 


B3 


1 


CPL 


C 
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Hex 


Number 






Code 


of Bytes 


Mnemonic 


Operands 


B4 


3 


CJNE 


A,#data , code addr 


B5 


3 


CJNE 


A, data addr, code addr 


B6 


3 


CJNE 


@ R0,#data ,code addr 


B7 


3 


CJNE 


@ R1 ,#data ,code addr 


B8 


3 


CJNE 


R0,#ctete, code addr 


B9 


3 


CJNE 


R1 ,#data ,code addr 


BA 


3 


CJNE 


R2,#data, code addr 


BB 


3 


CJNE 


R3,#data ,code addr 


BC 


3 


CJNE 


R4, tidata ,code addr 


BD 


3 


CJNE 


R5, tidata ,code addr 


BE 


3 


CJNE 


R6,#data ,code addr 


BF 


3 


CJNE 


R7, #data ,codeaddr 


GO 


2 


PUSH 


data addr 


C1 


2 


AJMP 


code addr 


C2 


2 


CLR 


bit addr 


C3 




CLR 


C 


C4 




SWAP 


A 


C5 


2 


XCH 


k,dataaddr 


C6 




XCH 


A,@R0 


C7 




XCH 


A,@R1 


C8 




XCH 


A,R0 


C9 




XCH 


A,R1 


CA 




XCH 


A,R2 


CB 




XCH 


A,R3 


CC 




XCH 


A,R4 


CD 




XCH 


A,R5 


CE 




XCH 


A,R6 


CF 




XCH 


A,R7 


DO 


2 


POP 


data addr 


D1 


2 


ACALL 


code addr 


D2 


2 


SETB 


bit addr 


D3 


1 


SETB 


C 


D4 


1 


DA 


A 


D5 


3 


DJNZ 


data addr, code addr 


D6 


1 


XCHD 


A,@R0 


D7 


1 


XCHD 


A,@R1 


D8 


2 


DJNZ 


HO, code addr 


D9 


2 


DJNZ 


R1 ,code addr 


DA 


2 


DJNZ 


R2,code addr 


DB 


2 


DJNZ 


R3, code addr 


DC 


2 


DJNZ 


RA, code addr 


DD 


2 


DJNZ 


R5,code addr 


DE 


2 


DJNZ 


B6,code addr 


DF 


2 


DJNZ 


Ki, code addr 


EO 


1 


MOVX 


A,@DPTR 


E1 


2 


AJMP 


code addr 


E2 




MOVX 


A,@R0 


E3 




MOVX 


A,@R1 


E4 




CLR 


A 


E5 


2 


MOV 


A, data addr 


E6 




MOV 


A,@R0 


E7 




MOV 


A,@R1 


E8 




MOV 


A,R0 


E9 




MOV 


A,R1 


EA 




MOV 


A,R2 


EB 




MOV 


A,R3 


EC 




MOV 


A,R4 


ED 




MOV 


A,R5 


EE 




MOV 


A,R6 


EF 




MOV 


A,R7 
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Table B-2. Instruction Opcodes in Hexadecimal (Cont'd.) 


Hex 
Code 


Number 
of Bytes 


Mnemonic 


Operands 


FO 


1 


MOVX 


@DPTR,A 


F1 


2 


ACALL 


code addr 


F2 




MOVX 


@R0,A 


F3 




MOVX 


@R1,A 


F4 




CPL 


A 


F5 


2 


MOV 


data addr, A 


F6 




MOV 


@R0,A 


F7 




MOV 


@R1,A 


F8 




MOV 


R0,A 


F9 




MOV 


R1,A 


FA 




MOV 


R2,A 


FB 




MOV 


R3,A 


FC 




MOV 


R4,A 


FD 




MOV 


R5.A 


FE 




MOV 


R6,A 


FF 




MOV 


R7,A 



B-13 




APPENDIX C 
ASSEMBLER DIRECTIVE SUMMARY 



Table C-l lists all the MCS-51 Macro Assembly Language directives. The format for 
each directive is shown along with a brief description of its operation. Complete 
descriptions of all directives are given in Chapter 4. 

Table C-l . Assembler Directives 



Directive 


Format 


Description 


BIT 


symbol— name BIT bit address 


Defines a bit address in bit data space. 


BSEG 


BSEG [AT absolute— address] 


Defines an absolute segment within the 
bit address space. 


CODE 


symbol— name CODE expression 


Assigns a symbol name to a specific 
address in the code space. 


CSEG 


CSEG [AT absolute— address] 


Defines an absolute segment within the 
code address space. 


DATA 


symbol— name DATA expression 


Assigns a symbol name to a specific 
on-chip data address. 


DB 


[label : ] D B expression— lis t 


Generates a list of byte values. 


DBIT 


[label:] DBIT expression 


Reserves a space in bit units in a BIT type 
segment. 


DS 


[label:] DS expression 


Reserves space in byte units; advances 
the location counter of the current 
segment. 


DSEG 


DSEG [AT absolute— address ] 


Defines an absolute segment within the 
indirect internal data space. 


DW 


[label:] DW expression— list 


Generates a list of word values. 


END 


END 


Indicates end of program. 


EQU 


symbol— name EQU expression 

or 
symbol name EQU special— assembler— symbol 


Set symbol value permanently. 


EXTRN 


EXTRN segment—type (symbol— names— list) 


Defines symbols referenced in the 
current module that are defined in other 
modules. 


IDATA 


symbol— name IDATA expression 


Assigns a symbol name to a specific 
indirect internal address. 


ISEG 


ISEG [AT absolute— address] 


Defines an absolute segment within the 
internal data space. 


NAME 


NAME module— name 


Specifies the name of the current module. 


ORG 


ORG expression 


Sets the location counter of the current 
segment. 


PUBLIC 


PUBUC list— of— names 


Identifies symbols which can be used 
outside the current module. 


RSEG 


RSEG segments. name 


Selects a relocatable segment. 


SEGMENT 


symbol— name SEGMENT segment— type 
repeatability 


Defines a relocatable segment. 


SET 


symbol^name SET expression 

or 
symbol— name SET special— assembler— symbol 


Sets symbol value temporarily. 
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Table C-l . Assembler Directives (Cont'd.) 



Directive 


Format 


Description 


USING 

XDATA 
XSEG 


USING expression 

symbol— name XDATA expression 
XSEG [AT absolute^address) 


Sets the predefined symbolic register 
address and causes the assembler to 
reserve space for the specified register 
bank. 

Assigns a symbol name to a specific 
off-chiD data address. 

Defines an absolute segment within the 
external data address space. 
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APPENDIX D 
ASSEMBLER CONTROL SUMMARY 



The table below contains all of the MCS-51 Macro assembler controls, their mean- 
ing, their defaults and their abbreviations. The table also defines whether the control 
is primary or general. (Primary controls must only appear at the head of the 
program or in the invocation lines; general controls may appear anywhere in the 
program.) 



Table D-l . Assembler Controls 



Name 


Primary/ 
General 


Default 


Abbrev. 


Meaning 


DATE(tfate) 


P 


DATE( ) 


DA 


Places string in header (max 
9 characters) 


DEBUG 


P 


NODEBUG 


DB 


Outputs debug symbol 
information to object file 


NODEBUG 


P 




NODB 


Symbol information not 
placed in object file 


EJECT 


G 


Not Applicable 


EJ 


Continue listing on next 
page 


ERRORPRINT[(F/L£)] 


P 


NOERRORPRINT 


EP 


Designates a file to receive 
error messages in addition 
to the listing file. File 
defaults to :co: 


NOERRORPRINT 


P 




NOEP 


Designates that error mes- 
sages will be printed in 
listing file 


GEN 


G 


GENONLY 


GE 


Generates a full listing of the 
macro expansion process 
including macro calls in the 
listing file 


GENONLY 


G 




GO 


List only the fully expanded 
source as if all lines gen- 
erated by a macro call were 
already in source file 


NOGEN 


G 




NOGE 


List only the original source 
text in listing file 


INCLUDE(F/LE) 


G 


Not Applicable 


IC 


Designates a file to be 
included as part of the 
program 


LIST 


G 


LIST 


LI 


Print subsequent lines of 
source in listing file 


NOLIST 


G 




NOLI 


Do not print subsequent 
lines of source in listing file 


MACRO [(mernpercent)] 


P 


MACRO(50) 


MR 


Evaluate and expand ail 
macro calls. Allocate 
percentage of free memory 
for macro processor 


NOMACRO 


P 




NOMR 


Do not evaluate macro calls 


OBJEGT[(F/LE)] 


P 


OBJECT(sofyrce.OBJ) 


OJ 


Designate file to receive 
object code 


NOOBJECT 


P 




NOOJ 


Designates that no object 
file will be created 


PAGING 


P 


PAGING 


PI 


Designates that listing will 
be broken into pages and 
each will have a header 


NOPAGING 


P 




NOPI 


Designates that listing will 
contain no page breaks 


PAGELENGTH(n) 


P 


PAGELENGTH(60) 


PL 


Sets maximum number of 
lines in each page of listing 
file (maximum = 65,535) 
(minimum = 10) 


PAGEWIDTH(n) 


P 


PAGEWIDTH(120) 


PW 


Sets maximum number of 
characters in each line of 
listing file (maximum = 132; 
minimum = 80) 
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Table D-l . Assembler Controls (Cont'd.) 



Name 


Primary/ 
General 


Default 


Abbrev. 


Meaning 


PRINT[(F/L£)] 


P 


PR\HJ(source. LST) 


PR 


Designates file to receive 
source listing 


NOPRINT 


P 




NOPR 


Designates that no listing 
file will be created 


SAVE 


G 


Not Applicable 


SA 


Stores current control set- 
ting for LIST and GEN 


RESTORE 


G 




RS 


Restores control setting 
from SAVE stack 


REGISTERBANK(rf>, ...) 
rb = 0,1,2, 3 


P 


REGISTERBANK(O) 


RB 


Indicates one or more banks 
used in program module 


NOREGISTERBANK 


P 




NORB 


Indicates that no banks are 
used. 


SYMBOLS 


P 


SYMBOLS 


SB 


Creates a formatted table of 
all symbols used in program 


NOSYMBOLS 


P 




NOSB 


No symbol table created 


TITLE(string) 


G 


TITLE( ) 


TT 


Places a string in all sub- 
sequent page headers 
(maximum 60 characters) 


WORKFILES(:Fn:[,:Fm:]) 


P 


same drive as 
source file 


WF 


Designates alternate drives 
for temporary workfiles 


XREF 


P 


NOXREF 


XR 


Creates a cross reference 
listing of all symbols used in 
program 


NOXREF 


P 




NOXR 


No cross reference list 
created 
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APPENDIX E 
MPL BUILT-IN FUNCTIONS 



The following is a list of all MPL built-in functions. 

% ' text end-of-line o r % ' text ' 

%{balanced-text) 

%*DEF\NE(call-pattern)[loca/-symbol-list](macro-body) 

%*DEE\HE(macro-name[parameter-list]) [LOCAL local-list] (macro-body) 

%n text-n-characters-long 

%EQS(arg1 ,arg2) 

% EVAL(expression ) 

%EXIT 

%GES(arg1 ,arg2) 

%GT$(arg1 ,arg2) 

%IF {expression) THEN {balanced-testl) [ELSE (balanced-text2)] Fl 

%IN 

%LEU(balanced-text) 

%LES(arg1 ,arg2) 

%LJS(arg1 ,arg2) 

%MATCH(identifier1 delimiter identified) (balanced-text) 

%MET ACH AR(balanced-text) 

%UE$(arg1 ,arg2) 

%OUl '(balanced-text) 

%REPEAT (expression) (balanced-text) 

%SET (macro-id .expression) 

%S\JBSTR(balanced-text,expression1,expression2) 

% WHILE (expression) (balanced-text) 
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APPENDIX F 
RESERVED SYMBOLS 



The following is a list of all of the MCS-51 Macro Assembly Language reserved sym- 
bols. They can not be used as symbol names or for any other purpose in your 
program. 




Opcodes 


ACALL 


DEC 


JNC 


NOP 


RRC 


ADD 


DIV 


JNZ 


ORL 


SETB 


ADDC 


DJNZ 


JZ 


POP 


SJMP 


AJMP 


INC 


LCALL 


PUSH 


SUBB 


ANL 


JB 


LJMP 


RET 


SWAP 


CJNE 


JBC 


MOV 


RETI 


XCH 


CLR 


JC 


MOVC 


RL 


XCHD 


CPL 


JMP 


MOVX 


RLC 


XRL 


DA 


JNB 


MUL 


RR 





Operands 


A 


EXTI1 


PC 


RD 


TB8 


AB 


FO 


PS 


REN 


TOON 


AC 


IE 


PSW 


RESET 


TFO 


ACC 


IE0 


PTO 


Rl 


TF1 


B 


IE1 


PT1 


RSO 


THO 


C 


IP 


PXO 


RS1 


TH1 


CY 


INTO 


PX1 


RXD 


Tl 


DPH 


INT1 


RO 


SBUF 


TIMERO 


DPL 


ITO 


R1 


SCON 


TIMER1 


DPTR 


IT1 


R2 


SINT 


TLO 


EA 


OV 


R3 


SMO 


TL1 


ES 


P 


R4 


SM1 


TMOD 


ETO 


PO 


R5 


SM2 


TRO 


ET1 


P1 


R6 


SP 


TR1 


EXO 


P2 


R7 


TO 


TXD 


EX1 


P3 


RB8 


T1 


WR 


EXTIO 


P4 









Symbolic Register Addresses 



ARO 
AR1 



AR2 
AR3 



AR4 
AR5 



AR6 
AR7 



Directives 



BIT 

BSEG 

CODE 

CSEG 

DATA 



DB 

DBIT 

DS 

DSEG 

DW 



END 

EQU 

EXTRN 

IDATA 

ISEG 



NAME 

ORG 

PUBLIC 

RSEG 

SEGMENT 



SET 
USING 
XDATA 
XSEG 
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APPENDIX G 
SAMPLE PROGRAM 



The following is a fully expanded listing file of an MCS-51 Macro Assembly 
Language program. This example includes three modules and their associated sym- 
bol table listings. 



MCS-51 MACRO ASSEMBLER 



SAMPLE 



PAGE 



ISIS-II MCS-51 MACRO ASSEMBLER V2.0 
33JECT MODULE PLACED IN : r 1 : S AM?1 . 06 J 
ASSEMBLER INVOKED BY: ASM51 : c 1 : S AMM . A5 1 



DEBUG 



LOC 03J 



LINE 



SOURCE 



0000 

000t< 753920 

0033 753003 

0006 7 5 9 5 A 

0009 023= 



0006 


900C00 


F 


OOOE 


123000 


c 


0011 


120000 


F 


0014 


900000 


F 


0017 


120000 


p 


O01A 


120000 


F 


0010 


7*00 


p 


001 r 


1 20000 


F 


0022 


120000 


p 


00 2 5 


900000 


c 


00 2d 


120000 


F 


0023 


120000 


F 


OOZE 


7SO0 


F 


0030 


120000 


F 


0033 


120000 


F 


0036 


7 900 


p 


003c 


120000 


c 


0033 


7900 


F 


3030 


120000 


F 


00^0 


E500 


c 


0042 


2500 


F 


0044 


F5QQ 


F 


0046 


7903 


F 


0045 


120300 


F 



0048 900000 



1 
2 
3 

4 
5 
6 
7 

9 
10 
11 
12 
13 

14 

15 
16 
17 
13 
19 
20 
21 
22 
23 
24 
25 
26 
11 

2 8 
29 
30 
31 

3 2 
33 
34 
35 
36 
37 
38 
39 
40 

41 

42 
43 

44 

45 
46 

4 7 
4o 
49 
50 



NAME SAMPLE 

EXTRN code (put.crlf/ put.string/ put.data.str/ 
EXTRN cod© (oinasc/ a s c b i n ) 



get.num) 



OR 
mo 

TO 

mo 



EG 

This is the initializing section. E 

starts at address on oouier-up. 

G 



xecution always 



TMOD/SC01C30C0B 
THl,*(-253> 
SCON/3110110103 
xo TR1 



, set timer mode to auto-reload 

; set timer for 110 BAUD 

/' prepare the Serial Port 

; start clock 



ST 

mo 

ca 
ca 



ca 
ca 

mo 
ca 



Thi 

u-'he 

inp 

ART 

typ 

v 

11 

11 

get 

v 

11 

11 



s is the main program. It's an infinite loop/ 
re each iteration prompts the console for 2 
ut numbers and types out their sum. 



ca 

mo 

ca 
ca 



mo 

ca 

f 

mov 

add 

mov 

; r 

mov 

ca 



-11 

get 

3V 

?11 

11 

v 

11 
?11 

con 

3V 

?11 
V 

11 

add 



e m 
0=>T 
put 
put 
fi 
OPT 
put 
out 
R0/ 
get 
put 



11 
out 



put 
put 
R0, 
get 
put 
ver 
R1/ 
asc 
R1, 
asc 
th 
a r 

sum 
ver 
R1, 
bin 
put 
OPT 



essag 
R/*ty 
.stri 
„crlf 
r s t n 
R/^nu 
.stri 
_crlf 

* n u m 1 

Icrlf 

cond 
R/^nu 
.stri 
_crif 

* n u m 2 
_ num 
Icrlf 
t the 
#num1 
bin 
*num2 
bin 

e 2 
uml 
um2 

r <* 

t SUM 
Ssum 

asc 
su 
R/ *su 



e explaining houi to correct a typo 

po.msc 
ng 

umber from console 

m 1 _ m s g 
no 



number from console 

m2 msg 



ASCII numbers to binary 



umbers/ and store th* results in SUM 



from binary to ASCII 

to console 
m_ms g 



Figure G-l . Sample Relocatable Program 
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Sample Program MCS-5 1 



LOC 


OBJ 




0Q4E 


120000 


F 


0051 


7900 


F 


0053 


7A04 




0055 


120000 


c 


0053 


80B1 





MCS-51 MACRO ASSEMBLER SAMPLE PAGE 2 

LINE SOURCE 

51 call put. string 

52 mov R1/*sum 

53 mov R2,#4 

54 call put.data.str 

55 jmp start 
56 

57 DSEG at 8 

0008 58 STACK: ds 8 ; at poiuer-up the stack pointer is 

59 ; initialized to point here 

60 ; 

01 DATA_AREA segment' DATA 

62 CONSTANT AREA segment CODE 

63 ; 

- — - 64 RSEG dsta.ares 

65 NUM1 : ds 4 

66 NUM2:- ds 4 

67 SUM: cis 4 
6 3 ; 

69 RSEG constant.area 

70 TYPO MSG: db 'TYPE A X TO RETYPE A NUMBSR'/OOH 



0000 




0004 




0008 




0000 


54595045 


0004 


2O5E5S20 


0003 


544F2052 


oooc 


45545950 


0010 


45204120 


0014 


4E554D42 


0018 


4552 


OOTA 


00 


0015 


54595045 


001F 


20494E^0 


0023 


46495253 


0027 


54204E55 


002B 


40424552 


002F 


3A20 


0031 


00 


0032 


54595045 


0036 


20494E20 


003A 


5345434 c 


003E 


4 c*4 204 t 


0042 


55404245 


0046 


523A20 


0049 


00 


004A 


54434520 


0045 


53554D20 


0052 


495320 


0055 


00 



71 NUM1.MSG: db 'TYPE IN FIRST NUMBER: '/00H 



72 NUM2.MSG: db 'TYPE IN SECOND NUMBER: '/00H 



73 SUM MSG: db 'THE SUM IS '/00H 



74 

75 ENO 



Figure G-l . Sample Relocatable Program (Cont'd.) 
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Sample Program 



MCS-51 MACRO ASSEMBLER 



SAMPLE 



PAGE 



SYM3QL TABLE LISTING 



NAME 



VALUE 



ATTRIBUTES 



ASCBIN 


• • . 


. C 


ADDR 







EXT 








BINASC. . . 


. C 


ADDR 







EXT 








CONSTANT. AREi 


* c 


SEG 


0056H 






REL = 


"UNIT 




DATA. AREA . 


. 


SEG 


OOOCH 






REL = 


"UNIT 




GET.NUM . . 


. c 


ADDR 


---- 




EXT 








NUM1.MSG. . 


. c 


ADOR 


001 oh 


R 




SEG: 


"CONSTANT. 


AREA 


NUM1 .... 





ADDR 


H 


R 




SEG = 
5EG = 


"DATA. AREA 
"CGNSTANT. 




NUM2.MSG. . 


. c 


ADDR 


0032H 


R 




AREA 


NUM^T . . . 


. D 


ADDR 


00G4H 


R 




SEG- 


"OATA.AREA 




PUT.CRLF. . 


. c 


ADDR 






EXT 








PUT. DATA. STR 


. c 


ADDR 







EXT 








PUT. STRING. 


. c 


ADDR 







EXT 








SAMPLE. . . 




















SCON. 







ADDR 


009SH 


A 










STACK 


• ■ • 


. D 


ADDR 


0008H 


A 










START . 


. . 


. C 


ADDR 


OOOBH 


A 










SUM.MSi 


9 m • 


. C 


ADOR 


004AH 


R 




SEG: 


"CONSTANT. 


AREA 


SUM . 




. D 


ADDR 


0008H 


R 




SES= 


"DATA. AREA 




TH'1 . 




. 




ADDR 
ADDR 


003DH 
00S9H 


A 
A 










TMOO. 






TR1 . 




. B 


ADDR 


0033H.6 


A 










TYPQ.M< 


>G. . . 


C 


ADDR 


OOOOH 


R 




SEG = 


"CONSTANT. 


AREA 



REGISTER BANKCS) USED: 0/ TARGET MACHINE(S): S051 
ASSEMBLY COMPLETE, NO ERRORS FOUND 



Figure G-l . Sample Relocatable Program (Cont'd.) 
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MCS-51 MACRO ASSEMBLER 



CONSOLE. 10 



PAGE 1 



ISIS-II MCS-51 MACRO ASSEM3LER V2.0 

OBJECT MODULE PLACED IN : F1 : SAMP2.0SJ 

ASSEMBLER INVOKED BY: ASM51 :F1 : S AMP2 . A51 DEBUG 



tOC OBJ 



0000 


OOOA 


0000 


7400 


0002 


120000 


0005 


740A 


0007 


120000 


OOOA 


22 



OOOB E4 
OOOC 93 
0000 6006 
OOOF 120000 

0012 A3 

0013 80F6 

0015 22 



0016 E7 

0017 120000 
001A 09 

001 B DAF9 
001D 22 



001 E 3099F0 
0021 C299 
0023 F599 
0025 22 



LINE 

1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 



SOURCE 

NAME CONSOLE. 10 

10. ROUTINES segment CODE 

RStG 10. ROUTINES 
; This is the console 10 routine cluster. 

PUBLIC put.crlf/ put. string/ put.data.str^ get. nun 

USING 
/ 

; This routine outputs a Carriage Return and 
; a Line Feed 
PUT.CRLF: 
CR equ ODH 
L c equ OAH 

i 

mov A/#cr 

call put. char 

mov A/31f 

call put. char 
ret 



carriage return 
line feed 



f Rout 

' in C 
'UT.ST 
clr 
mov 
jz 
cal 
inc 
jmp 
EXIT: 
ret 



ine outputs a null-terminated string located 
00E memory/ whose address is given in DPTR. 

RING: 
A 

A/3A+DPTR 
exit 

put. char 
OPTR 
put. string 



' Routine outputs a string located in DATA memory^ 
' whose address is in R1 and its length in R2. 

'UT.OATA.STR: 
mov A/3R1 
call put. char 
inc R1 

djnz R2/put.data.str 
ret 

r 

t This routine outputs a single character to console. 

f The character is given in A. 

'UT.CHAR: 

jnb TI/$ 

TI 

SBUF,A 



clr 
mov 
ret 



This routine gets a 4 character string fro* console 



Figure G-l . Sample Relocatable Program (Cont'd.) 
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MCS-51 



Sample Program 



MCS-51 MACRO ASSEMBLER 



CONSOLE. 10 



PAGE 



LOC OBJ 



LINE 



SOURCE 



0026 7A04 
0028 A900 

002A 120000 



002D C2E7 
002F B41805 
0032 120000 F 
0035 30EF 

0037 F7 

0038 09 

0039 DAEF 
003B 22 



003C 3098FD 

003F C298 

0041 E599 

0043 22 



51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
73 



; and stores it in memory at the address given in RO. 
; If b *X is received/ routine starts over again* 
GET.NUM: 

mov R2**4 ; set up string length as 4 
mov R1/AR0 ; R0 value may be needed for restart 
GET. LOOP: 

call get. char 
; Next 4 instructions handle A X- the routine starts 
/ over if received 

clr ACC.7 ; clear the parity bit 

cjne A,#18H,G0.0N ; if not A X- go on 
call put.crlf 
jmp get.num 
GO. ON: 

mov 3R1sA 

inc R1 

djnz R2*get.loop 

ret 

r 

; This routine gets a single character from console. 
; The character is returned in A. 
GET. CHAR: 

jnb RI,$ 

clr RI 

mov AsSBUF 

ret 

END 



MCS-51 MACRO ASSEMBLER 



CONSOLE. 10 



PAGE 



SYMBOL TABLE LISTING 



NAME 



TYPE 



VALUE 



ATTRIBUTES 



ACC* 






D 



ADDR 
AODR 


00E0H 
OOOOH 


A 
A 










AR0. . . - - 




CONSOLE.' 


[0 . 




CR , 






C 


NUMB 
ADDR 


OOODH 
0015H 


A 

R 




SEG* 


'10. 




EXIT 




. , 


.ROUTINES 


GET. 


.CHAR 


. , 


c 


ADDR 


003CH 


R 




SEG = 


=10. ROUTINES 


GET. 


.LOOP 


. , 


c 


ADOR 


002Ah 


R 




SEG = 


= 10. 


.ROUTINES 


GET 


.NUM. 


. , 


c. 


ADDR 


0026H 


R 


PUB 


SEG= 


10. 


.ROUTINES 


GO. ON. • 


. , 


c 


ADDR 


0037H 


R 




SEG = 


=10. ROUTINES 


I0.R0UTI! 


VIES. 


c 


SEG 


0044H 






REL = 


= UNIT 


LF , 






, c 


NUMB 

ADDR 


OOOAH 
001 EH 


A 
R 




SEG = 


: io. 




ojT. 


.CHAR 


. 


.ROUTINES 


PUT.CRLF 


. , 


c 


ADDR 


OOOOH 


R 


PUB 


SEG = 


= 10. 


.ROUTINES 


PUT.OATA 


.st; 


? c 


AODR 


0016H 


R 


=>U3 


SEG = 


= 10. 


.ROUTINES 


PUT. STRING . 


c 


ADDR 


000SH 


R 


PUB 


SEG = 


=10. ROUTINES 


RI 






. s 

. D 


ADDR 
ADDR 


00V8H.0 
0099H 


A 
A 










S3UF . . 


. 




TI 






. B 


ADDR 


0094H.1 


A 











REGISTER BANKCS) USED: 0/ TARGET MACHINE(S): 8051 
ASSEMBLY COMPLETE/ NO ERRORS FOUND 



Figure G-l . Sample Relocatable Program (Cont'd.) 
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Sample Program 



MCS-51 



MCS-51 MACRO ASSEMBLER 



NUM.CONVERSICN 



PAGE 1 



ISIS-II MCS-51 MACRO ASSEM3LER V2.0 

OBJECT MODULE PLACED IN : M : SAMP3 . 03 J 

ASSEMBLER INVOKED BY: ASM51 : F1 : S AMP3 . A51 DEBUG 



LOC OBJ 



LINE 



SOURCE 



0030 
002B 
002D 



0000 A801 

REG 
0302 03 

0003 E6 

0004 C3 

0005 9430 
0007 75F064 
OOOA A4 
OOOB FB 

OOOC 08 
0000 E6 
OOOt 9430 
0010 75F00A 

0013 A4 

0014 2B 

0015 FB 

0016 08 

0017 E6 

0018 C3 

0019 9430 
001B 2B 
001C FB 



1 
2 
3 

4 

5 

6 

7 

3 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49' 
50 



NAME NUM. CONVERSION 



NUM.RO 
RSE 
; This 
; and 
; inte 

; asci 

/ i.e. 
PU3 
USI 

ZERO 
PLUS 
MINUS 



UTIN 

G N 

mod 

back 

gars 

I re 

a s 

LIC 

NG 

EQU 

EQU 

EQU 



ES segment CODE 

UM.ROUTINES 

uie handles conversion from ASCII to binary 

The binary numbers are signed one-byte 

i.e. their range is -128 to +127. Their 

presantation is always 4 characters long- 

ign followed by 3 digits. 

ascbin* binasc 


'0' 



This routine converts ASCII to binary. 
INPUT- a 4 character string pointed at by R1. The 
number range must be -128 to +127/ and the 
string must have 3 digits preceded by a sign. 
OUTPUT- a signed one-byte integer* located where 
the input string started (pointed at by R1)« 
ASC3IN: 

mov R0/AR1 ; R1 original value is needed later 
; Compute first digit value* and store it in TEMP 
TEMP equ R3 

inc R0 

mov A/2R0 

clr C 

subb A/tfzero 

mov 5/*10Q 

mul AS 

mov TEMP/A 
; Compute the second digit value 

inc R0 

mov A*2R0 

subb A/Hzero 

mov 8/#1 

mul AB 
; Add the value of the second digit to num. 

add A/TEMP 

mov TEMP/A 
; get third digit and its value to total 

inc R0 

mov A*3R0 

clr C 

subb Ar#zero 

add A, TEMP 

mov TEMP/A 
; test the sign/ and complement the number if the 
; sign is a minus 



Figure G-l . Sample Relocatable Program (Cont'd.) 
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Sample Program 



MCS-51 MACRO ASSEMBLER 



NUM. CONVERSION 



PAGE 



L3C OBJ 

0010 E7 

001E B42D04 

0021 EB 

0022 F4 

0023 04 

0024 FB 



0025 EB 

0026 F7 

0027 22 



00E7 

0028 E7 

002V 7726 

002B 30E704 

002E 7720 

0030 14 

0031 c 4 



0032 09 

0033 75F064 

0036 84 

0037 2430 

0039 F7 

003A 09 
003S E5F0 
003D 75F00A 

0040 84 

0041 2430 

0043 F7 

0044 09 

0045 E5<=0 
0047 2430 
0049 F7 

004A 22 



INE 


SOURCE 




51 




mov 


A/2R1 


52 




c jne 


A/ tfaiinus/pos 


53 








54 




mov 


A/ TEMP 


55 




cpi 


A 


56 




mc 


A 


57 




mov 


TEMP, A 


58 


; 






59 


/ 


epilogue- store the r 


60 


pes : 




61 




mov 


A, TEMP 


62 




mo v 


5R1/A 


63 




ret 




04 


; 






65 


; 


Tnis 


routine converts 


66 


; 


INPUT 


a signed one- 


o7 


; 


OUTPUT- a 4 character 


63 


; 


input number was ( 


69 


5 


INiASC: 




70 


SIGN bit ACC.7 


71 


; 


Get the n u m b s r / find 


72 




mc v 


A/SR1 


73 




mov 


3R1 /*plus 


74 








75 




jno 


sign/ co_on2 


7o 


; 


Next 


3 instructions h 


77 




mov 


3R1 / tfminus 


76 




dec 


A 


79 




cpi 


A 


3C 


/ 


Factor out the first 


c1 


GC.0N2: 




52 




mc 


R1 


S3 




mov 


8, #100 


54 




cii v 


A3 


85 




B 6 6 


A f *2?ro 


86 




mov 


3R1/A 


37 


/ 


Factor out the second 


33 




inc 


R1 


3 9 




mov 


A, 3 


90 




mov 


B,#10 


91 




div 


A5 


92 




add 


A/ #zero 


93 




mov 


3R1/A 


94 


/ 


Store 


the third digit 


95 




inc 


R1 


96 




mov 


A/6 


97 




add 


A/ ft zero 


98 




mov 


2R1/A 


99 


/ 


note 


that we return w 


100 




ret 




101 


; 






102 


E 


MO 





;skip the next 4 instructions 
/'if the number is positive 



result and exit 



binary to ASCII, 
byte integer/ pointed at by R1 

string/ located inhere the 
pointed at by R1). 



its sign and store its sign 

/'store a plus sign (over- 
written by minus if needed) 
;test the sign bit 
andle negative numbers 
;store a minus sign 



digit 



;store the first digit 
digit 



Pstore the second digit 



;store the third digit 
ithout restoring R1 



Figure G-l . Sample Relocatable Program (Cont'd.) 
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Sample Program MCS-51 



MCS-51 MACRO ASSEMBLER NUM.CONVERS ION PAGE 

SYMBOL TABLE LISTING 

NAME TYPE VALUE ATTRIBUTES 

ACC AODR 

AR1 D ADDS 

ASC6IN .... C ADOR 

o. ..... . C ADOR 

BINASC .... C AODR 

GG_QN2 .... C AODR 

MINUS NUM5 

NUM. CONVERSION 

NUM. ROUTINES . C SEG 

PLUS NUMB 

POS C AODR 

SIGN 5 ADOR 

TEMP REG 

ZERO NUMB 

REGISTER 3ANK(S) USED: 0/ TARGET MACHINECS): 8051 
ASSEMBLY COMPLETE/ NO ERRORS FOUND 



E H 


A 






0001H 


A 






OOOOH 


R 


PU3 


SEG=NUM_ROUTINES 


OOFOH 


A 






0028H 


R 


PUB 


SEG=NUM_ ROUTINES 


0032H 


R 




SEG=NUM. ROUTINES 


0C20H 


A 






0043H 






REL=UNIT 


0029H 


A 






0025H 


R 




SEG=NUM. ROUTINES 


0050H.7 


A 






R3 








0030H 


A 







Figure G-l . Sample Relocatable Program (Cont'd.) 
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APPENDIX H 
REFERENCE TABLES 



This appendix contains the following general reference tables: 

• ASCII codes 

• Powers of two 

• Powers of 16 (in base 10) 

• Powers of 10 (in base 16) 

• Hexadecimal-decimal integer conversion 



ASCII Codes 

The 8051 uses the 7-bit ASCII code, with the high-order 8th bit (parity bit) always 
reset. 



GRAPHIC OR 


ASCII 


CONTROL 


(HEXADECIMAL) 


NUL 


00 


SOH 


01 


STX 


02 


ETX 


03 


EOT 


04 


ENQ 


05 


ACK 


06 


BEL 


07 


BS 


08 


HT 


09 


LF 


0A 


VT 


0B 


FF 


0C 


CR 


0D 


SO 


OE 


SI 


OF 


DLE 


10 


DC1 (X-ON) 


11 


DC2 (TAPE) 


12 


DC3 (X-OFF) 


13 


DC4 (TAPE) 


14 


NAK 


15 


SYN 


16 


ETB 


17 


CAN 


18 


EM 


19 


SUB 


1A 


ESC 


1B 


FS 


1C 


GS 


1D 


RS 


1E 


US 


1F 


SP 


20 


i 


21 




22 


# 


23 


$ 


24 


% 


25 


& 


26 


* 


27 


{ 


28 


) 


29 


* 


2A 



GRAPHIC OR 


ASCII 


CONTROL 


(HEXADECIMAL) 


+ 


2B 


t 


2C 


- 


2D 




2E 


/ 


2F 





30 


1 


31 


2 


32 


3 


33 


4 


34 


5 


35 


6 


36 


7 


37 


8 


38 


9 


39 




3A 


• 


3B 


< 


3C 


= 


3D 


> 


3E 


? 


3F 


@ 


40 


A 


41 


B 


42 


C 


43 


D 


44 


E 


45 


F 


46 


G 


47 


H 


48 


I 


49 


J 


4A 


K 


4B 


L 


4C 


M 


4D 


N 


4E 





4F 


P 


50 


Q 


51 


R 


52 


s 


53 


T 


54 


U 


55 



GRAPHIC OR 


ASCII 


CONTROL (HEXADECIMAL) 


V 


56 


w 


57 


X 


58 


Y 


59 


z 


5A 


[ 


5B 


\ 


5C 


] 


5D 


Aft) 


5E 


-(<-) 


5F 


* 


60 


a 


61 


b 


62 


c 


63 


d 


64 


e 


65 


f 


66 


9 


67 


h 


68 


i 


69 


J 


6A 


k 


6B 


I 


6C 


m 


6D 


n 


6E 





6F 


P 


70 


q 


71 


r 


72 


s 


73 


t 


74 


u 


75 


V 


76 


w 


77 


X 


78 


y 


79 


z 


7A 


1 

\ 


7B 


1 


7C 


J (ALT MODE) 


7D 


- 


7E 


DEL (RUB OUT) 


7K 



H-l 



Reference Tables MCS-51 

POWERS OF TWO 



2" 


n 2 




1 

2 

4 
8 


1.0 

1 0.5 

2 25 

3 125 




16 

32 

64 

128 


4 0.062 

5 0.031 

6 0.015 

7 0.007 


5 

25 
625 
812 5 



256 8 003 906 25 
512 9 0.001 953 125 

1 024 10 0.000 976 562 5 

2 048 11 0.000 488 281 25 

4 096 12 000 244 140 625 

8 192 13 0.000 122 070 312 5 
16 384 14 000 061 035 156 25 
32 768 15 0.000 030 517 578 125 

65 536 16 0.000 015 258 789 062 5 
131 072 17 0.000 007 629 394 531 25 
262 144 18 000 003 814 697 265 625 
524 288 19 0.000 001 907 348 632 812 5 

1 048 576 20 000 000 953 674 316 406 25 

2 097 152 21 000 000 476 837 158 203 125 

4 194 304 22 000 000 238 418 579 101 562 5 
8 388 608 23 000 000 119 209 289 550 781 25 

16 777 216 24 0.000 000 059 604 644 775 390 625 

33 554 432 25 000 000 029 802 322 387 695 312 5 

67 108 864 26 000 000 014 901 161 193 847 656 25 

134 217 728 27 000 000 007 450 580 596 923 828 125 

268 435 456 28 000 000 003 725 290 298 461 914 062 5 

536 870 912 29 000 000 001 862 645 149 230 957 031 25 i 

1 073 741 824 30 000 000 000 931 322 574 615 478 515 625 

2 147 483 648 31 000 000 000 465 661 287 307 739 257 812 5 

4 294 967 296 32 000 000 000 232 830 643 653 869 628 906 25 

8 589 934 592 33 000 000 000 1 16 415 321 826 934 814 453 125 

17 179 869 184 34 000 000 000 058 207 660 913 467 407 226 562 5 

34 359 738 368 35 000 000 000 029 103 830 456 733 703 613 281 25 

68 719 476 736 36 000 000 000 014 551 915 228 366 851 806 640 625 

137 438 953 472 37 0.000 000 000 007 275 957 614 183 425 903 320 312 5 

274 877 906 944 38 0.000 000 000 003 637 978 807 091 712 951 660 156 25 

549 755 813 888 39 0.000 000 000 001 818 989 403 545 856 4 75 830 078 125 

1 099 511 627 776 40 000 000 000 000 909 494 701 772 928 237 915 039 062 5 

2 199 023 255 552 41 0.000 000 000 000 4^4 747 350 886 464 118 957 519 531 25 
4 398 046 511 104 42 000 000 000 000 227 373 675 443 232 059 478 759 765 625 

8 796 093 022 208 43 000 000 000 000 113 686 837 721 616 029 739 379 882 812 5 

17 592 186 044 416 44 000 000 000 000 056 843 418 860 808 014 869 689 941 406 25 

35 184 372 088 832 45 000 000 000 000 028 421 709 430 404 007 434 844 970 703 125 

70 368 744 177 664 46 000 000 000 000 014 210 854 715 202 003 717 422 485 351 562 5 

140 737 488 355 328 47 0.000 000 000 000 007 105 427 357 601 001 858 711 242 675 781 25 

281 474 976 710 656 48 0.000 000 000 000 003 552 713 678 800 500 929 355 621 337 890 625 

562 949 953 421 312 49 000 000 000 000 001 776 356 839 400 250 464 677 810 668 945 312 5 

1 125 899 906 842 624 50 0.000 000 000 000 000 888 178 419 700 125 232 338 905 334 472 656 25 

2 251 799 813 685 248 51 000 000 000 000 000 444 089 209 850 062 616 169 452 667 236 328 125 

4 503 599 627 370 496 52 000 000 000 000 000 222 044 604 925 031 308 084 726 333 618 164 062 5 

9 007 199 254 740 992 53 000 000 000 000 000 111 022 302 462 515 654 042 363 166 809 082 031 25 

18 014 398 509 481 984 54 000 000 000 000 000 055 511 151 231 257 827 021 181 583 404 541 015 625 

36 028 797 018 963 968 55 000 000 000 000 000 027 755 575 615 628 913 510 590 791 702 270 507 812 5 

72 057 594 037 927 936 56 000 000 000 000 000 013 877 787 807 814 456 755 295 395 851 135 253 906 25 

144 115 188 075 855 872 57 000 000 000 000 000 006 938 893 903 907 228 377 647 697 925 567 676 950 125 

288 230 376 151 711 744 58 000 000 000 000 000 003 469 446 951 953 614 188 823 848 962 783 813 476 562 5 

576 460 752 303 423 488 59 000 000 000 000 000 001 734 723 475 976 807 094 411 924 481 391 906 738 281 25 

1 152 921 504 606 846 976 60 000 000 000 000 000 000 867 361 737 988 403 547 205 962 240 695 953 369 140 625 

2 305 843 009 213 693 952 61 000 000 000 000 000 000 433 680 868 994 201 773 602 981 120 347 976 684 570 312 5 r : 
4 611 686 018 427 387 904 62 0.000 000 000 000 000 000 216 840 434 497 100 886 801 490 560 173 988 342 285 156 25 \i 
9 223 372 036 854 775 808 63 000 000 000 000 000 000 108 420 217 248 550 443 400 745 280 086 994 171 142 578 125 
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POWERS OF 16 (IN BASE 10) 
















16 n 


n 






16 


-n 














1 





0.10000 


00000 


00000 


00000 


X 


10 










16 


1 


0.62500 


00000 


00000 


00000 


X 


io-' 










256 


2 


0.39062 


50000 


00000 


00000 


X 


10- 2 








4 


096 


3 


0.24414 


06250 


00000 


00000 


X 


10- 3 








65 


536 


4 


0.15258 


78906 


25000 


00000 


X 


10" 4 






1 


048 


576 


5 


0.95367 


43164 


06250 


00000 


X 


10" 6 






16 


777 


216 


6 


0.59604 


64477 


53906 


25000 


X 


10- 7 






268 


435 


456 


7 


0.37252 


90298 


46191 


40625 


X 


10~ 8 




4 


294 


967 


296 


8 


0.23283 


06436 


53869 


62891 


X 


10" 9 




68 


719 


476 


736 


9 


0.14551 


91522 


83668 


51807 


X 


io- ,G 


1 


099 


511 


627 


776 


10 


0.90949 


47017 


72928 


23792 


X 


10" 12 


17 


592 


186 


044 


416 


11 


0.56843 


41886 


08080 


14870 


X 


10" 13 


281 


474 


976 


710 


656 


12 


0.35527 


13678 


80050 


09294 


X 


10" 14 


4 503 


599 


627 


370 


496 


13 


0.22204 


46049 


25031 


30808 


X 


10" 15 


72 057 


594 


037 


927 


936 


14 


0.13877 


78780 


78144 


56755 


X 


10" 16 


152 921 


504 


606 


846 


976 


15 


0.86736 


17379 


88403 


54721 


X 


10" 18 



POWERS OF 10 (IN BASE 16) 









10" 


n 




10 


-n 














1 





1.0000 


0000 


0000 


0000 












A 


1 


0.1999 


9999 


9999 


999A 












64 


2 


0.28F5 


C28F 


5C28 


F5C3 


X 


16' 1 








3E8 


3 


0.4189 


374B 


C6A7 


EF9E 


X 


16" 2 








2710 


4 


0.68DB 


8BAC 


710C 


B296 


X 


16~ 3 






1 


86A0 


5 


0.A7C5 


AC47 


1B47 


8423 


X 


16- 4 






F 


4240 


6 


0.1 0C6 


F7A0 


B5ED 


8D37 


X 


16" 4 






98 


9680 


7 


0.1 AD7 


F29A 


BCAF 


4858 


X 


16~ 5 






5F5 


E100 


8 


0.2AF3 


1DC4 


6118 


73BF 


X 


16~ 6 






3B9A 


CAOO 


9 


0.44B8 


2FA0 


9B5A 


52CC 


X 


16" 7 




2 


540B 


E400 


10 


0.6DF3 


7F67 


SEF6 


EADF 


X 


16" 8 




17 


4876 


E800 


11 


O.AFEB 


FFOB 


CB24 


AAFF 


X 


16" 9 




E8 


D4A5 


1000 


12 


0.1 197 


9981 


2DEA 


1119 


X 


16" 9 




918 


4E72 


A000 


13 


0.1 C25 


C268 


4976 


81 C2 


X 


16- 10 




5AF3 


107A 


4000 


14 


0.2D09 


370D 


4257 


3604 


X 


16~ n 


3 


8D7E 


A4C6 


8000 


15 


0.480E 


BE7B 


9D58 


566D 


X 


16" 12 


23 


8652 


6FC1 


0000 


16 


0.734A 


CA5F 


6226 


FOAE 


X 


16~ 13 


163 


4578 


5D8A 


0000 


17 


0.B877 


AA32 


36A4 


B449 


X 


16- 14 


DEO 


B6B3 


A764 


0000 


18 


0.1272 


5DD1 


D243 


ABA1 


X 


16' 14 


1AC7 


2304 


89E8 


0000 


19 


0.1 D83 


C94F 


B6D2 


AC35 


X 


16- ,s 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION 



The table below provides for direct conversions between hexadecimal integers in the range 0-FFF and decimal integers in the 
range 0-4095. For conversion of larger integers, the table values may be added to the following figures: 



Hexadecimal 


Decimal 


Hexadecimal 


Decimal 


01000 


4 096 


20 000 


131 072 


02 000 


8 192 


30 000 


196 608 


03 000 


12 288 


40 000 


262 144 


04 000 


16 384 


50 000 


327 680 


05 000 


20 480 


60 000 


393 216 


06 000 


24 576 


70 000 


458 752 


07 000 


28 672 


80 000 


524 288 


08 000 


32 768 


90 000 


589 824 


09 000 


36 864 


A0 000 


655 360 


0A000 


40 960 


BO 000 


720 896 


OB 000 


45 056 


CO 000 


786 432 


0C000 


49 152 
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1756 


1757 


1758 


1759 


6E0 


1760 


1761 


1762 


1763 


1764 


1765 


1766 


1767 


1768 


1769 


1770 


1771 


1772 


1773 


1774 


1775 


6F0 


1776 


1777 


1778 


1779 


1780 


1781 


1782 


1783 


1784 


1785 


1786 


1787 


1788 


1789 


1790 


1791 



H-6 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 





E 


F 


700 


1792 


1793 


1794 


1795 


1796 


1797 


1798 


1799 


1800 


1801 


1802 


1803 


1804 


1805 


1806 


1807 


710 


1808 


1809 


1810 


1811 


1812 


1813 


1814 


1815 


1816 


1817 


1818 


1819 


1820 


1821 


1822 


1823 


720 


1824 


1825 


1826 


1827 


1828 


1829 


1830 


1831 


1832 


1833 


1834 


1835 


1836 


1837 


1838 


1839 


730 


1840 


1841 


1842 


1843 


1844 


1845 


1846 


1847 


1848 


1849 


1850 


1851 


1852 


1853 


1854 


1855 


740 


1856 


1857 


1858 


1859 


1860 


1861 


1862 


1863 


1864 


1865 


1866 


1867 


1868 


1869 


1870 


1871 


750 


1872 


1873 


1874 


1875 


1876 


1877 


1878 


1879 


1880 


1881 


1882 


1883 


1884 


1885 


1886 


1887 


760 


1888 


1889 


1890 


1891 


1892 


1893 


1894 


1895 


1896 


1897 


1898 


1899 


1900 


1901 


1902 


1903 


770 


1904 


1905 


1906 


1907 


1908 


1909 


1910 


1911 


1912 


1913 


1914 


1915 


1916 


1917 


1918 


1919 


780 


1920 


1921 


1922 


1923 


1924 


1925 


1926 


1927 


1928 


1929 


1930 


1931 


1932 


1933 


1934 


1935 


790 


1936 


1937 


1938 


1939 


1940 


1941 


1942 


1943 


1944 


1945 


1946 


1947 


1948 


1949 


1950 


1951 


7A0 


1952 


1953 


1954 


1955 


1956 


1957 


1958 


1959 


1960 


1961 


1962 


1963 


1964 


1965 


1966 


1967 


7B0 


1968 


1969 


1970 


1971 


1972 


1973 


1974 


1975 


1976 


1977 


1978 


1979 


1980 


1981 


1982 


1983 


7C0 


1984 


1985 


1986 


1987 


1988 


1989 


1990 


1991 


1992 


1993 


1994 


1995 


1996 


1997 


1998 


1999 


7D0 


2000 


2001 


2002 


2003 


2004 


2005 


2006 


2007 


2008 


2009 


2010 


2011 


2012 


2013 


2014 


2015 


7E0 


2016 


2017 


2018 


2019 


2020 


2021 


2022 


2023 


2024 


2025 


2026 


2027 


2028 


2029 


2030 


2031 


7F0 


2032 


2033 


2034 


2035 


2036 


2037 


2038 


2039 


2040 


2041 


2042 


2043 


2044 


2045 


2046 


2047 


800 


2048 


2049 


2050 


2051 


2052 


2053 


2054 


2055 


2056 


2057 


2058 


2059 


2060 


2061 


2062 


2063 


810 


2064 


2065 


2066 


2067 


2068 


2069 


2070 


2071 


2072 


2073 


2074 


2075 


2076 


2077 


2078 


2079 


820 


2080 


2081 


2082 


2083 


2084 


2085 


2086 


2087 


2088 


2089 


2090 


2091 


2092 


2093 


2094 


2095 


830 


2096 


2097 


2098 


2099 


2100 


2101 


2102 


2103 


2104 


2105 


2106 


2107 


2108 


2109 


2110 


2111 


840 


2112 


2113 


2114 


2115 


2116 


2117 


2118 


2119 


2120 


2121 


2122 


2123 


2124 


2125 


2126 


2127 


850 


2128 


2129 


2130 


2131 


2132 


2133 


2134 


2135 


2136 


2137 


2138 


2139 


2140 


2141 


2142 


2143 


860 


2144 


2145 


2146 


2147 


2148 


2149 


2150 


2151 


2152 


2153 


2154 


2155 


2156 


2157 


2158 


2159 


870 


2160 


2161 


2162 


2163 


2164 


2165 


2166 


2167 


2168 


2169 


2170 


2171 


2172 


2173 


2174 


2175 


880 


2176 


2177 


2178 


2179 


2180 


2181 


2182 


2183 


2184 


2185 


2186 


2187 


2188 


2189 


2190 


2191 


890 


2192 


2193 


2194 


2195 


2196 


2197 


2198 


2199 


2200 


2201 


2202 


2203 


2204 


2205 


2206 


2207 


8A0 


2208 


2209 


2210 


2211 


2212 


2213 


2214 


2215 


2216 


2217 


2218 


2219 


2220 


2221 


2222 


2223 


8B0 


2224 


2225 


2226 


2227 


2228 


2229 


2230 


2231 


2232 


2233 


2234 


2235 


2236 


2237 


2238 


2239 


8C0 


2240 


2241 


2242 


2243 


2244 


2245 


2246 


2247 


2248 


2249 


2250 


2251 


2252 


2253 


2254 


2255 


800 


2256 


2257 


2258 


2259 


2260 


2261 


2262 


2263 


2264 


2265 


2266 


2267 


2268 


2269 


2270 


2271 


8E0 


2272 


2273 


2274 


2275 


2276 


2277 


2278 


2279 


2280 


2281 


2282 


2283 


2284 


2285 


2286 


2287 


8F0 


2288 


2289 


2290 


2291 


2292 


2293 


2294 


2295 


2296 


2297 


2298 


2299 


2300 


2301 


2302 


2303 


900 


2304 


2305 


2306 


2307 


2308 


2309 


2310 


2311 


2312 


2313 


2314 


2315 


2316 


2317 


2318 


2319 


910 


2320 


2321 


2322 


2323 


2324 


2325 


2326 


2327 


2328 


2329 


2330 


2331 


2332 


2333 


2334 


2335 


920 


2336 


2337 


2338 


2339 


2340 


2341 


2342 


2343 


2344 


2345 


2346 


2347 


2348 


2349 


2350 


2351 


930 


2352 


2353 


2354 


2355 


2356 


2357 


2358 


2359 


2360 


2361 


2362 


2363 


2364 


2365 


2366 


2367 


940 


2368 


2369 


2370 


2371 


2372 


2373 


2374 


2375 


2376 


2377 


2378 


2379 


2380 


2381 


2382 


2383 


950 


2384 


2385 


2386 


2387 


2388 


2389 


2390 


2391 


2392 


2393 


2394 


2395 


2396 


2397 


2398 


2399 


960 


2400 


2401 


2402 


2403 


2404 


2405 


2406 


2407 


2408 


2409 


2410 


2411 


2412 


2413 


2414 


2415 


970 


2416 


2417 


2418 


2419 


2420 


2421 


2422 


2423 


2424 


2425 


2426 


2427 


2428 


2429 


2430 


2431 


980 


2432 


2433 


2434 


2435 


2436 


2437 


2438 


2439 


2440 


2441 


2442 


2443 


2444 


2445 


2446 


2447 


990 


2448 


2449 


2450 


2451 


2452 


2453 


2454 


2455 


2456 


2457 


2458 


2459 


2460 


2461 


2462 


2463 


9A0 


2464 


2465 


2466 


2467 


2468 


2469 


2470 


2471 


2472 


2473 


2474 


2475 


2476 


2477 


2478 


2479 


9B0 


2480 


2481 


2482 


2483 


2484 


2485 


2486 


2487 


2488 


2489 


2490 


2491 


2492 


2493 


2494 


2495 


9C0 


2496 


2497 


2498 


2499 


2500 


2501 


2502 


2503 


2504 


2505 


2506 


2507 


2508 


2509 


2510 


2511 


900 


2512 


2513 


2514 


2515 


2516 


2517 


2518 


2519 


2520 


2521 


2522 


2523 


2524 


2525 


2526 


2527 


9E0 


2528 


2529 


2530 


2531 


2532 


2533 


2534 


2535 


2536 


2537 


2538 


2539 


2540 


2541 


2542 


2543 


9F0 


2544 


2545 


2546 


2547 


2548 


2549 


2550 


2551 


2552 


2553 


2554 


2555 


2556 


2557 


2558 


2559 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


A00 


2560 


2561 


2562 


2563 


2564 


2565 


2566 


2567 


2568 


2569 


2570 


2571 


2572 


2573 


2574 


2575 


A10 


2576 


2577 


2578 


2579 


2580 


2581 


2582 


2583 


2584 


2585 


2586 


2587 


2588 


2589 


2590 


2591 


A20 


2592 


2593 


2594 


2595 


2596 


2597 


2598 


2599 


2600 


2601 


2602 


2603 


2604 


2605 


2606 


2607 


A30 


2608 


2609 


2610 


2611 


2612 


2613 


2614 


2615 


2616 


2617 


2618 


2619 


2620 


2621 


2622 


2623 


A40 


2624 


2625 


2626 


2627 


2628 


2629 


2630 


2631 


2632 


2633 


2634 


2635 


2636 


2637 


2638 


2639 


A50 


2640 


2641 


2642 


2643 


2644 


2645 


2646 


2647 


2648 


2649 


2650 


2651 


2652 


2653 


2654 


2655 


A60 


2656 


2657 


2658 


2659 


2660 


2661 


2662 


2663 


2664 


2665 


2666 


2667 


2668 


2669 


2670 


2671 


A70 


2672 


2673 


2674 


2675 


2676 


2677 


2678 


2679 


2680 


2681 


2682 


2683 


2684 


2685 


2686 


2687 


A80 


2688 


2689 


2690 


2691 


2692 


2693 


2694 


2695 


2696 


2697 


2698 


2699 


2700 


2701 


2702 


2703 


A90 


2704 


2705 


2706 


2707 


2708 


2709 


2710 


2711 


2712 


2713 


2714 


2715 


2716 


2717 


2718 


2719 


AAO 


2720 


2721 


2722 


2723 


2724 


2725 


2726 


2727 


2728 


2729 


2730 


2731 


2732 


2733 


2734 


2735 


ABO 


2736 


2737 


2738 


2739 


2740 


2741 


2742 


2743 


2744 


2745 


2746 


2747 


2748 


2749 


2750 


2751 


ACO 


2752 


2753 


2754 


2755 


2756 


2757 


2758 


2759 


2760 


4761 


2762 


2763 


2764 


2765 


2766 


2767 


ADO 


2768 


2769 


2770 


2771 


2772 


2773 


2774 


2775 


2776 


2777 


2778 


2779 


2780 


2781 


2782 


2783 


AEO 


2784 


2785 


2786 


2787 


2788 


2789 


2790 


2791 


2792 


2793 


2794 


2795 


2796 


2797 


2798 


2799 


AFO 


2800 


2801 


2802 


2803 


2804 


2805 


2806 


2807 


2808 


2809 


2810 


2811 


2812 


2813 


2814 


2815 


BOO 


2816 


2817 


2818 


2819 


2820 


2821 


2822 


2823 


2824 


2825 


2826 


2827 


2828 


2829 


2830 


2831 


B10 


2832 


2833 


2834 


2835 


2836 


2837 


2838 


2839 


2840 


2841 


2842 


2843 


2844 


2845 


2846 


2847 


B20 


2848 


2849 


2850 


3851 


2852 


2853 


2854 


2855 


2856 


2857 


2858 


2859 


2860 


2861 


2862 


2863 


B30 


2864 


2865 


2866 


2867 


2868 


2869 


2870 


2871 


2872 


2873 


2874 


2875 


2876 


2877 


2878 


2879 


B40 


2880 


2881 


2882 


2883 


2884 


2885 


2866 


2887 


2888 


2889 


2890 


2891 


2892 


2893 


2894 


2895 


B50 


2896 


2897 


2898 


2899 


2900 


2901 


2902 


2903 


2904 


2905 


2906 


2907 


2908 


2909 


2910 


2911 


B60 


2912 


2913 


2914 


2915 


2916 


2917 


2918 


2919 


2920 


2921 


2922 


2923 


2924 


2925 


2926 


2927 


B70 


2928 


2929 


2930 


2931 


2932 


2933 


2934 


2935 


2936 


2937 


2938 


2939 


2940 


2941 


2942 


2943 


B80 


2944 


2945 


2946 


2947 


2948 


2949 


2950 


2951 


2952 


2953 


2954 


2955 


2956 


2957 


2958 


2959 


B90 


2960 


2961 


2962 


2963 


2964 


2965 


2966 


2967 


2968 


2969 


2970 


2971 


2972 


2973 


2974 


2975 


BAO 


2976 


2977 


2978 


2979 


2980 


2981 


2982 


2983 


2984 


2985 


2986 


2987 


2988 


2989 


2990 


2991 


BBO 


2992 


2993 


2994 


2995 


2996 


2997 


2998 


2999 


3000 


3001 


3002 


3003 


3004 


3005 


3006 


3007 


BCO 


3008 


3009 


3010 


3011 


3012 


3013 


3014 


3015 


3016 


3017 


3018 


3019 


3020 


3021 


3022 


3023 


BDO 


3024 


3025 


3026 


3027 


3028 


3029 


3030 


3031 


3032 


3033 


3034 


3035 


3036 


3037 


3038 


3039 


BEO 


3040 


3041 


3042 


3043 


3044 


3045 


3046 


3047 


3048 


3049 


3050 


3051 


3052 


3053 


3054 


3055 


BFO 


3056 


3057 


3058 


3059 


3060 


3061 


3062 


3063 


3064 


3065 


3066 


3067 


3068 


3069 


3070 


3071 


COO 


3072 


3073 


3074 


3075 


3076 


3077 


3078 


3079 


3080 


3081 


3082 


3083 


3084 


3085 


3086 


3087 


C10 


3088 


3089 


3090 


3091 


3092 


3093 


3094 


3095 


3096 


3097 


3098 


3099 


3100 


3101 


3102 


3103 


C20 


3104 


3105 


3106 


3107 


3108 


3109 


3110 


3111 


3112 


3113 


3114 


3115 


3116 


3117 


3118 


3119 


C30 


3120 


3121 


3122 


3123 


3124 


3125 


3126 


3127 


3128 


3129 


3130 


3131 


3132 


3133 


3134 


3135 


C40 


3136 


3137 


3138 


3139 


3140 


3141 


3142 


3143 


3144 


3145 


3146 


3147 


3148 


3149 


3150 


3151 


C50 


3152 


3153 


3154 


3155 


3156 


3157 


3158 


3159 


3160 


3161 


3162 


3163 


3164 


3165 


3166 


3167 


C60 


3168 


3169 


3170 


3171 


3172 


3173 


31 74 


3175 


3176 


3177 


3178 


3179 


3180 


3181 


3182 


3183 


C70 


3184 


3185 


3186 


3187 


3188 


3189 


3190 


3191 


3192 


3193 


3194 


3195 


3196 


3197 


3198 


3199 


C80 


3200 


3201 


3202 


3203 


3204 


3205 


3206 


3207 


3208 


3209 


3210 


3211 


3212 


3213 


3214 


3215 


C90 


3216 


3217 


3218 


3219 


3220 


3221 


3222 


3223 


3224 


3225 


3226 


3227 


3228 


3229 


3230 


3231 


CAO 


3232 


3233 


3234 


3235 


3236 


3237 


3238 


3239 


3240 


3241 


3242 


3243 


3244 


3245 


3246 


3247 


CBO 


3248 


3249 


3250 


3251 


3252 


3253 


3254 


3255 


3256 


3257 


3258 


3259 


3260 


3261 


3262 


3263 


CCO 


3264 


3265 


3266 


3267 


3268 


3269 


3270 


3271 


3272 


3273 


3274 


3275 


3276 


3277 


3278 


3279 


CDO 


3280 


3281 


3282 


3283 


3284 


3285 


3286 


3287 


3288 


3289 


3290 


3291 


3292 


3293 


3294 


3295 


CEO 


3296 


3297 


3298 


3299 


3300 


3301 


3302 


3303 


3304 


3305 


3306 


3307 


3308 


3309 


3310 


3311 


CFO 


3312 


3313 


3314 


3315 


3316 


3317 


3318 


3319 


3320 


3321 


3322 


3323 


3324 


3325 


3326 


3327 
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HEXADECIMAL-DECIMAL INTEGER CONVERSION (Cont'd) 








1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


D00 


3328 


3329 


3330 


3331 


3332 


3333 


3334 


3335 


3336 


3337 


3338 


3339 


3340 


3341 


3342 


3343 


D10 


3344 


3345 


3346 


3347 


3348 


3349 


3350 


3351 


3352 


3353 


3354 


3355 


3356 


3357 


3358 


3359 


D20 


3360 


3361 


3362 


3363 


3364 


3365 


3366 


3367 


3368 


3369 


3370 


3371 


3372 


3373 


3374 


3375 


D30 


3376 


3377 


3378 


3379 


3380 


3381 


3382 


3383 


3384 


3385 


3386 


3387 


3388 


3389 


3390 


3391 


D40 


3392 


3393 


3394 


3395 


3396 


3397 


3398 


3399 


3400 


3401 


3402 


3403 


3404 


3405 


3406 


3407 


D50 


3408 


3409 


3410 


3411 


3412 


3413 


3414 


3415 


3416 


3417 


3418 


3419 


3420 


3421 


3422 


3423 


D60 


3424 


3425 


3426 


3427 


3428 


3429 


3430 


3431 


3432 


3433 


3434 


3435 


3436 


3437 


3438 


3439 


D70 


3440 


3441 


3442 


3443 


3444 


3445 


3446 


3447 


3448 


3449 


3450 


3451 


3452 


3453 


3454 


3455 


D80 


3456 


3457 


3458 


3459 


3460 


3461 


3462 


3463 


3464 


3465 


3466 


3467 


3468 


3469 


3470 


3471 


D90 


3472 


3473 


3474 


3475 


3476 


3477 


3478 


3479 


3480 


3481 


3482 


3483 


3484 


3485 


3486 


3487 


DAO 


3488 


3489 


3490 


3491 


3492 


3493 


3494 


3495 


3496 


3497 


3498 


3499 


3500 


3501 


3502 


3503 


DBO 


3504 


3505 


3506 


3507 


3508 


3509 


3510 


3511 


3512 


3513 


3514 


3515 


3516 


3517 


3518 


3519 


DCO 


3520 


3521 


3522 


3523 


3524 


3525 


3526 


3527 


3528 


3529 


3530 


3531 


3532 


3533 


3534 


3535 


DDO 


3536 


3537 


3538 


3539 


3540 


3541 


3542 


3543 


3544 


3545 


3546 


3547 


3548 


3549 


3550 


3551 


DEO 


3552 


3553 


3554 


3555 


3556 


3557 


3558 


3559 


3560 


3561 


3562 


3563 


3564 


3565 


3566 


3567 


DFO 


3568 


3569 


3570 


3571 


3572 


3573 


3574 


3575 


3576 


3577 


3578 


3579 


3580 


3581 


3582 


3583 


EOO 


3584 


3585 


3586 


3587 


3588 


3589 


3590 


3591 


3592 


3593 


3594 


3595 


3596 


3597 


3598 


3599 


E10 


3600 


3601 


3602 


3603 


3604 


3605 


3606 


3607 


3608 


3609 


3610 


3611 


3612 


3613 


3614 


3615 


E20 


3616 


3617 


3618 


3619 


3620 


3621 


3622 


3623 


3624 


3625 


3626 


3627 


3628 


3629 


3630 


3631 


E30 


3632 


3633 


3634 


3635 


3636 


3637 


3638 


3639 


3640 


3641 


3642 


3643 


3644 


3645 


3646 


3647 


E40 


3648 


3649 


3650 


3651 


3652 


3653 


3654 


3655 


3656 


3657 


3658 


3659 


3660 


3661 


3662 


3663 


E50 


3664 


3665 


3666 


3667 


3668 


3669 


3670 


3671 


3672 


3673 


3674 


3675 


3676 


3677 


3678 


3679 


E60 


3680 


3681 


3682 


3683 


3684 


3685 


3686 


3687 


3688 


3689 


3690 


3691 


3692 


3693 


3694 


3695 


E70 


3696 


3697 


,3698 


3699 


3700 


3701 


3702 


3703 


3704 


3705 


3706 


3707 


3708 


3709 


3710 


3711 


E80 


3712 


3713 


3714 


3715 


3716 


3717 


3718 


3719 


3720 


3721 


3722 


3723 


3724 


3725 


3726 


3727 


E90 


3728 


3729 


3730 


3731 


3732 


3733 


3734 


3735 


3736 


3737 


3738 


3739 


3740 


3741 


3742 


3743 


EAO 


3744 


3745 


3746 


3747 


3748 


3749 


3750 


3751 


3752 


3753 


3754 


3755 


3756 


3757 


3758 


3759 


EBO 


3760 


3761 


3762 


3763 


3764 


3765 


3766 


3767 


3768 


3769 


3770 


3771 


3772 


3773 


3774 


3775 


ECO 


3776 


3777 


3778 


3779 


3780 


3781 


3782 


3783 


3784 


3785 


3786 


3787 


3788 


3789 


3790 


3791 


EDO 


3792 


3793 


3794 


3795 


3796 


3797 


3798 


3799 


3800 


3801 


3802 


3803 


3804 


3805 


3806 


3807 


EEO 


3808 


3809 


3810 


3811 


3812 


3813 


3814 


3815 


3816 


3817 


3818 


3819 


3820 


3821 


3822 


3823 


EFO 


3824 


3825 


3826 


3827 


3828 


3829 


3830 


3831 


3832 


3833 


3834 


3835 


3836 


3837 


3838 


3839 


FOO 


3840 


3841 


3842 


3843 


3844 


3845 


3846 


3847 


3848 


3849 


3850 


3851 


3852 


3853 


3854 


3855 


F10 


3856 


3857 


3858 


3859 


3860 


3861 


3862 


3863 


3864 


3865 


3866 


3867 


3868 


3869 


3870 


3871 


F20 


3872 


3873 


3874 


3875 


3876 


3877 


3878 


3879 


3880 


3881 


3882 


3883 


3884 


3885 


3886 


3887 


F30 


3888 


3889 


3890 


3891 


3892 


3893 


3894 


3895 


3896 


3897 


3898 


3899 


3900 


3901 


3902 


3903 


F40 


3904 


3905 


3906 


3907 


3908 


3909 


3910 


3911 


3912 


3913 


3914 


3915 


3916 


3917 


3918 


3919 


F50 


3920 


3921 


3922 


3923 


3924 


3925 


3926 


3927 


3928 


3929 


3930 


3931 


3932 


3933 


3934 


3935 


F60 


3936 


3937 


3938 


3939 


3940 


3941 


3942 


3943 


3944 


3945 


3946 


3947 


3948 


3949 


3950 


3951 


F70 


3952 


3953 


3954 


3955 


3956 


3957 


3958 


3959 


3960 


3961 


3962 


3963 


3964 


3965 


3966 


3967 


F80 


3968 


3969 


3970 


3971 


3972 


3973 


3974 


3975 


3976 


3977 


3978 


3979 


3980 


3981 


3982 


3983 


F90 


3984 


3985 


3986 


3987 


3988 


3989 


3990 


3991 


3992 


3993 


3994 


3995 


3996 


3997 


3998 


3999 


FAO 


4000 


4001 


4002 


4003 


4004 


4005 


4006 


4007 


4008 


4009 


4010 


4011 


4012 


4013 


4014 


4015 


FBO 


4016 


4017 


4018 


4019 


4020 


4021 


4022 


4023 


4024 


4025 


4026 


4027 


4028 


4029 


4030 


4031 


FCO 


4032 


4033 


4034 


4035 


4036 


4037 


4038 


4039 


4040 


4041 


4042 


4043 


4044 


4045 


4046 


4047 


FDO 


4048 


4049 


4050 


4051 


4052 


4053 


4054 


4055 


4056 


4057 


4058 


4059 


4060 


4061 


4062 


4063 


FEO 


4064 


4065 


4066 


4067 


4068 


4069 


4070 


4071 


4072 


4073 


4074 


4075 


4076 


4077 


4078 


4079 


FFO 


4080 


4081 


4082 


4083 


4084 


4085 


4086 


4087 


4088 


4089 


4090 


4091 


4092 


4093 


4094 


4095 
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APPENDIX J 
ERROR MESSAGES 



When the assembler is unable to correctly assemble a source file, it generates an 
error message describing the trouble. If possible, it will continue execution. In some 
cases the assembler is unable to continue (e.g., too many symbols in a program), and 
it must abort execution. If your program should generate an error message, make 
the necessary corrections and reassemble. The object file will probably not be 
executable, and, if the error caused an abort, the list file may also be unreadable. 

The general format for all errors listed in your code is shown below: 

*** ERROR #eee, LINE #/// (ppp), Message 

where: 

eee is the error number 

III is the line causing the error 

ppp is the line causing the lost error 

Message is the error message. 

(See Chapter 6 for a complete description of all error messages generated by the 
assembler.) 
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Error Messages MCS-51 

Source File Error Messages 

This type of error is caused by syntactic errors in your source code. They appear in ^ 

your listing file immediately following the source line that caused the error. 

In attempting to further define the error, ASMS 1 may generate more than one 
message for a single error. Since the assembler attempts to continue processing your 
code, a single error may have side effects that cause subsequent errors. 

A list of all Assembler Error messages is shown below: 

Assembler Error Messages 

1 SYNTAX ERROR 

2 SOURCE LINE LISTING TERMINATED AT 255 CHARACTERS 

3 ARITHMETIC OVERFLOW IN NUMERIC CONSTANT 

4 ATTEMPT TO DIVIDE BY ZERO 

5 EXPRESSION WITH FORWARD REFERENCE NOT ALLOWED 

6 TYPE OF SET SYMBOL DOES NOT ALLOW REDEFINITION 

7 SYMBOL ALREADY DEFINED 

8 ATTEMPT TO ADDRESS NON-BIT-ADDRESSABLE BIT 

9 BAD BIT OFFSET IN BIT ADDRESS EXPRESSION 

10 TEXT FOUND BEYOND END STATEMENT-IGNORED 

11 PREMATURE END OF FILE (NO END STATEMENT) 

12 ILLEGAL CHARACTER IN NUMERIC CONSTANT 

13 ILLEGAL USE OF REGISTER NAME IN EXPRESSION 

14 SYMBOL IN LABEL FIELD ALREADY DEFINED 

15 ILLEGAL CHARACTER 

16 MORE ERRORS DETECTED, NOT REPORTED 

17 ARITHMETIC OVERFLOW IN LOCATION COUNTER 

18 UNDEFINED SYMBOL ( 

19 VALUE WILL NOT FIT INTO A BYTE 

20 OPERATION INVALID IN THIS SEGMENT 

21 STRING TERMINATED BY END-OF-LINE 

22 STRING LONGER THAN 2 CHARACTERS NOT ALLOWED IN THIS CONTEXT 

23 STRING, NUMBER, OR IDENTIFIER CANNOT EXCEED 225 CHARACTERS 

24 DESTINATION ADDRESS OUT OF RANGE FOR INBLOCK REFERENCE 

25 DESTINATION ADDRESS OUT OF RANGE FOR RELATIVE REFERENCE 

26 SEGMENT SYMBOL EXPECTED 

27 ABSOLUTE EXPRESSION EXPECTED 

28 REFERENCE NOT TO CURRENT SEGMENT 

29 IDATA SEGMENT ADDRESS EXPECTED 

30 PUBLIC ATTRIBUTE NOT ALLOWED FOR THIS SYMBOL 

31 EXTERNAL REFERENCE NOT ALLOWED IN THIS CONTEXT 

32 SEGMENT REFERENCE NOT ALLOWED IN THIS CONTEXT 

33 TOO MANY RELOCATABLE SEGMENTS 

34 TOO MANY EXTERNAL SYMBOLS 

35 LOCATION COUNTER MAY NOT POINT BELOW SEGMENT BASE 

36 CODE SEGMENT ADDRESS EXPECTED 

37 DATA SEGMENT ADDRESS EXPECTED 

38 XDATA SEGMENT ADDRESS EXPECTED 

39 BIT SEGMENT ADDRESS EXPECTED 

40 BYTE OF BIT ADDRESS NOT IN BIT-ADDRESSABLE DATA SEGMENT 

41 INVALID HARDWARE REGISTER 

42 BAD REGISTER BANK NUMBER 

43 INVALID SIMPLE RELOCATABLE EXPRESSION 

44 INVALID RELOCATABLE EXPRESSION 

45 INPAGE RELOCATED SEGMENT OVERFLOW 

46 INBLOCK RELOCATED SEGMENT OVERFLOW 

47 BIT ADDRESSABLE RELOCATED SEGMENT OVERFLOW 

48 ILLEGAL RELOCATION FOR SEGMENT TYPE 
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MCS-5 1 Error Messages 



Macro Error Messages 

Macro errors are caused by errors using the Macro Processing Language (MPL). 
They are listed immediately following the line in which the error was recognized, and 
is followed by a trace of the macro call/expression stack. This is not necessarily the 
line that contains the error. 

Since the Macro Processor attempts to define the error completely, several messages 
may be generated. A macro error may be responsible for subsequent macro errors 
and assembler errors. 

All of the Macro Error messages are listed below: 



Macro Error Messages 

300 MORE ERRORS DETECTED, NOT REPORTED 

301 UNDEFINED MACRO NAME 

302 ILLEGAL EXIT MACRO 

303 FATAL SYSTEM ERROR 

304 ILLEGAL EXPRESSION 

305 MISSING "Fl" IN "IF" 

306 MISSING "THEN" IN "IF" 

307 ILLEGAL ATTEMPT TO REDEFINE MACRO 

308 MISSING IDENTIFIER IN DEFINE PATTERN 

309 MISSING BALANCED STRING 

310 MISSING LIST ITEM 

311 MISSING DELIMITER 

312 PREMATURE EOF 

313 DYNAMIC STORAGE (MACROS OR ARGUMENTS) OVERFLOW 

314 MACRO STACK OVERFLOW 

315 INPUT STACK OVERFLOW 

317 PATTERN TOO LONG 

318 ILLEGAL METACHARACTER: <char> 

319 UNBALANCED ")" IN ARGUMENTTO USER DEFINED MACRO 

320 ILLEGAL ASCENDING CALL 
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Error Messages MCS-51 

Control Error Messages 

Control errors are announced when something is wrong with the invocation line or a 
control line in the source file. In general, command language errors are fatal, caus- 
ing ASM51 to abort assembly. However, the errors listed below are not considered 
fatal. 

Control Error Messages 

400 MORE ERRORS DETECTED NOT REPORTED 

401 BAD PARAMETER TO CONTROL 

402 MORE THAN ONE INCLUDE CONTROL ON A SINGLE LINE 

403 ILLEGAL CHARACTER IN COMMAND 

406 TOO MANY WORKFILES— ONLY FIRST TWO USED 

407 UNRECOGNIZED CONTROL OR MISPLACED PRIMARY CONTROL: <control> 

408 NO TITLE FOR TITLE CONTROL 

409 NO PARAMETER ALLOWED WITH ABOVE CONTROL 

410 SAVE STACK OVERFLOW 

411 SAVE STACK UNDERFLOW 

413 PAGEWIDTH BELOW MINIMUM, SET TO 80 

414 PAGELENGTH BELOW MINIMUM, SETTO 10 

415 PAGEWIDTH ABOVE MAXIMUM, SET T0 132 
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Special Assembler Error Messages 

These error messages are displayed on the console. They are displayed immediately 
before the assembler aborts operation. You should never receive one of these errors; 
if you should encounter this type of error notify Intel Corporation via the Software 
Problem Report included with this manual. The content of all output files will be 
undefined. A list of all of the special assembler error messages is shown below: 

Special Assembler Error Messages 

800 UNRECOGNIZED ERROR MESSAGE NUMBER 

801 SOURCE FILE READING UNSYNCHRONIZED 

802 INTERMEDIATE FILE READING UNSYNCHRONIZED 

803 BAD OPERAND STACK POP REQUEST 

804 PARSE STACK UNDERFLOW 

805 INVALID EXPRESSION STACK CONFIGURATION 
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Error Messages MCS-51 

Fatal Error Messages 

This type of error causes the assembler to cease normal processing and produce only 
the listing. 

900 USER SYMBOL TABLE SPACE EXHAUSTED 

901 PARSE STACK OVERFLOW 

902 EXPRESSION STACK OVERFLOW 

903 INTERMEDIATE FILE BUFFER OVERFLOW 

904 USER NAME TABLE SPACE EXHAUSTED 



Invocation Line Error Messages 

Invocation line errors cause the assembler to abort execution. 

NO SOURCE FILE FOUND IN INVOCATION 

UNRECOGNIZED SOURCE FILE NAME 

ILLEGAL SOURCE FILE SPECIFICATION 

SOURCE TEXT MUST COME FROM A FILE 

NOT ENOUGH MEMORY 

_AND_FILES ARE THE SAME 

BAD WORKFILES COMMAND 

BAD WORKFILES SYNTAX 

BAD PAGELENGTH 

BADPAGEWIDTH 

PAGELENGTH MISSING A PARAMETER 

PAGEWIDTH MISSING A PARAMETER 

DATE MISSING A PARAMETER 

CANNOT HAVE INCLUDE IN INVOCATION 

EOL ENCOUNTERED IN PARAMETER 

COMMAND TOO LONG 

ILLEGAL CHARACTER IN INVOCATION 

UNRECOGNIZED COMMAND : <control name> 

NO PARAMETER ALLOWED WITH control 

TITLE MtSSING A PARAMETER 

TOO MANY RESTORES 

NO PARAMETER GIVEN FOR "REGISTERBANKS" 

ERROR IN PARAMETER LIST FOR "REGISTERBANKS" 



J-6 




APPENDIX K 

CHANGING ABSOLUTE PROGRAMS 

TO RELOCATABLE PROGRAMS 



The program example on the following pages illustrates an absolute program written 
to run on any member of the MCS-51 family of single-chip processors. This pro- 
gram includes two simple ASCII-binary conversion routines and a set of output 
routines. 

The structure of this sample program can be examined and contrasted to the sample 
modular program shown in Appendix G. 



MCS-51 MACRO ASSEMBLER 



PAGE 



ISIS-II MCS-51 MACRO ASSEMBLER V1.0 

NO OBJECT MODULE REQUESTED 

ASSEMBLER INVOKED BY: ASM51 ; F1 : SAMPLE . A51 NOOJ 



LOC OBJ 



0BB3 



DBS 8 


54595045 


OBBC 


205E5320 


OBCO 


544F2052 


0SC4 


45545950 


0BC8 


45204120 


03CC 


4E554D42 


0600 


4552 


0302 


00 


0SD3 


54595045 


0BD7 


20494E20 


0SOB 


46495253 


03DF 


54204E55 


0BE3 


40424552 


03E7 


3A20 


QBS9 


00 


03EA 


54595045 


0B5E 


20494E20 


03F2 


5345434F 


03 F 6 


4E44204E 


03FA 


554D4245 


03FE 


523A2C 


0C01 


00 


0C02 


54484520 


0C06 


53554D20 


0C0A 


495320 


0C0D 


00 



0000 

0000 758920 
0003 753003 
0006 75930A 
0009 028E 



0008 900BB8 

000E 120065 

0011 12005A 

0014 900B03 



LINE 

1 
2 
3 

4 



8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 



SOURCE 

CSEG 

ORG 3000 

; STRING DEFINITIONS 

TYPC MSG: db 'TYPE *X 



TO RETYPE A NUMBER', 00H 



NUM1 MSG: db 'TYPE IN FIRST NUMBER: # ,OQH 



NUM2.MSG: db 'TYPE IN SECOND NUMBER: *,00H 



SUM.MSG: 



db 'THE SUM IS ",00H 



CSEG 

; This is the initializing section. 

; starts at address on power-up. 

ORG 

mov TMOD, #001000003 

mov THl/#(-253) 

mov SCON, #110110103 

setb TR1 



Execution always 



set timer mode to auto-reload 
set timer for 110 BAUD 
prepare the Serial Port 
start clock 



; This is the main program. It's 9r\ infinite loop, 

; where each iteration prompts the console for 2 

/ input numbers and types out their sum. 

START: 

; type message explaining how to correct a typo 

mov 0PTR,#typo_msg 

call put. string 

call put_crlf 

; get first number from console 

mov DPTR,#num1_msg 

Figure K-l. Sample Absolute Program 
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PAGE 



LQC 08J 

0017 120065 

001A 12005A 

0010 7830 

001F 120030 

0022 12005A 



0025 


9008EA 


0028 


120065 


0023 


12005A 


002c 


7834 


0033 


120080 


0033 


12005A 


003o 


7930 


0038 


120090 


0035 


7934 


0030 


120093 


0040 


E530 


0042 


2534 


0044 


F538 


004 6 


7938 


0048 


1200C5 


004B 


900C02 


CQ4c 


120065 


0051 


7938 


0053 


7A04 


0055 


12007Q 


0058 


80B1 


0008 




0308 





0030 
0030 
0034 
0038 



0000 


000A 


005A 


7400 


005C 


120078 


005F 


740A 


0061 


120078 


0064 


2* 



006 5 E4 

0066 93 

0067 6006 
0069 12037c 
006C A3 
006D 8 OF 6 

006F 22 



0070 E7 



LINE 

29 
30 
31 
32 
33 
34 
35 
36 
37 
33 
39 
40 
41 
42 
43 

44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
53 
59 
&0 
61 
62 
63 
64 
65 
66 
67 
63 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
31 
32 
83 
84 
85 
86 
37 
83 
39 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 



SOURCE 

call put.string 

call put.crlf 

niov R0/#num1 

call get.num 

call put.crlf 

/ get second number from console 

mov DPTR* *num2_msg 

call out. string 

call put.crlf 

mov R0r#num2 

call get.num 

call put.crlf 

/ convert the ASCII numbers to binary 

mov R1/#num1 

call ascbin 

mov R1/*num2 

call ascbin 

/" add the 2 numbers/ and store the results in SUM 

mov a/num1 

add a/num2 

mov sum/a 

; convert SUM from binary to ASCII 



mov 


R1 /Hisum 


call 


binasc 


/ output sum to console 


mov 


0?TR/ 3sum_msg 


call 


put. string 


mc v 


R1/#sum 


mov 


R2/#4 


call 


put.data.str 


jmp 


start 


0SEG 




ORG S 


STACK: ds 3 ; at oo 




; initia 


DSEG 




ORG 30H 


NUM1 : 


; ds 4 


NUM2: 


: ds 4 


SUM: 


ds 4 



; at poiuei — up the stack pointer is 
initialized to point here 



CSEG 

; This is the console 10 routine cluster. 

/ 

1 This routine outputs a Carriage Return and 

; a Line Feed 

PUT.CRLF: 

CR equ QDH ; carriage return 

LF equ 0AH ; line feed 

mov A/#cr 
call put. char 
mov A*#lf 
call put.char 
ret 

; Routine outputs a null-terminated string located 
; in CODE memory/ whose address is given in DPTR, 
=>UT_STRING: 

clr A 

move A/SA+OPTR 

jz exit 

call put.char 

inc 0PTR 

jmp put.string 
EXIT: 

ret 

/ Routine outputs a string located in DATA memory* 
; whosa address is in R1 and its length in R2. 
PUT.3ATA.STR: 
mov A • 3 R 1 

Figure K-l . Sample Absolute Program (Cont'd.) 
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LOC OBJ 



LINE 



SOURCE 



0071 120073 

0074 09 

0075 DAF9 
0077 22 



0078 3099F0 

0073 C299 

0070 F599 

007F 22 



OOaO 7A04 
0082 A9Q0 



0084 120095 



0087 C2E7 

0089 B41804 
008C 115A 
008E 80F0 

0090 F7 

0091 09 

0092 DAFO 
0094 22 



0095 3098F0 

0098 C298 

009A E599 

009C 22 



0030 
0023 
0020 



0090 A801 

REG 
009F 08 
OOAO E6 
00A1 C3 
00A2 9430 
GOA* 75F064 
00A7 A 4 
0QA8 F6 

00A9 08 
OOAA 56 
OOAB 9430 
OOAD 75F00A 
0030 A4 



103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
123 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
153 
159 
160 

1o1 
162 
163 
164 
165 
166 
167 
163 
169 
170 
171 
172 
173 
174 
175 
176 



call put.char 

inc R1 

djnz R2/Out_data_str 

; This routine outputs a single character to console. 
; The character is given in A. 
PUT. CHAR: 

jnb T I /i 

clr TI 

mov S3UF/A 

ret 



GET 

; n 



s rou 
stor 
a A X 

UM: 
R2 
R1 
OOP: 
11 ge 
t 4 i 
r if 
clr 
c jne 
call 
jmp 



tine gets a 4 character string from console 
s it in memory at the address given in RO. 
is received/ routine starts over again. 

/*4 ; set up string length as 4 

/00H ; RO value may be needed for restart 



t_char 

nstructions handle 
received 

ACC.7 ; 

A/#18H/G0.0N ; 

put_crlf 

get_num 



A X- the routine starts 

clear the parity bit 
if not *X- go on 



GO. 



3R1/A 
c R1 
nz R2/get_loop 
t 



; This routine gets a single character from console. 
; The character is returned in A. 
GET. CHAR: 

jnb RI/$ 

clr RI 

mov A/SBUF 

ret 

; This section handles conversion from ASCII to binary 

/ and back. The Dinary numbers are signed one-byte 

; integers/ i.e. their range is -128 to +127. Their 

; ASCII representation is always 4 characters long- 

; i.e. a sign followed by 3 digits. 

ZERO EQU '0* 
PLUS EQU '+* 
MINUS EQU '-' 




ASC3IM 

mov R0/001H 
; Compute first 
TEMP equ R3 

inc 

mov 

clr 



/ R1 original value is needed 1 
igit value/ and store it in TEMP 



later 



R0 

A/3R0 

C 

subbA/#zero 
mov 8/3100 
mul AS 
mov TEMP/A 
Compute the second digit value 
inc R0 
mov A/3R0 
subb A/«zero 
mov 3/*10 
mul AS 



Figure K-l . Sample Absolute Program (Cont'd.) 
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LOC OBJ 



LINE 



SOURCE 



0031 23 
00B2 F6 

0083 08 

00B4 E6 

0035 C3 

00B6 9430 

00B8 2B 

00B9 FB 



OOBA E7 
OOBB B42004 

OOBE E8 
OOBF F4 

00C0 04 
00C1 FB 



00C2 ES 
00C3 F7 
00C4 11 



00E7 

00C5 E7 
00C6 7723 

00C8 30E704 

OOCB 772D 
OOCD 14 
OOCE F4 



OOCF 09 

3000 75F064 

0003 84 

0004 2430 

0006 F7 

0007 09 
0003 E5F0 
OOOA 75F00A 
0000 SA 
OODE 2430 
00E0 F7 

30E1 09 

0OE2 E5F0 

00E4 2430 

00E6 F7 

00E7 22 



177 

173 
179 
180 
131 
132 
183 
134 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
1V5 
196 
197 
193 
199 
200 
201 
202 
203 
204 
205 
206 
207 
205 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
22a 
225 
226 
227 
22 S 
229 
230 
231 
232 
233 
234 
235 
236 
237 
233 
239 
240 



/ Add the value of the second digit to num. 

add A, TEMP 

mo v TEMP/ A 
; get third digit and its value to total 

inc RO 

mov A/SRO 

clr C 

subb A/#zero 

add A/TEMP 

mov TEMP/A 
; test the sign^ and complement the number if the 
/ sign is a minus 

mov A/3R1 

cjne A/flminus/pos /skip the next 4 instructions 
;if the number is positive 

mov A, TEMP 

cpl A 

inc A 

mov TEMP /A 
/ 

; epilogue- store the result ar\<i exit 
pos : 

mov A/TEMP 

mov 3R1 /A 

ret 



inary to ASCII, 
te integer/ pointed at by R-1 
tring/ located where the 
inted at by R1 ) • 



This routine converts b 
INPUT- a signed one- by 
OUTPUT- a 4 character s 
input number was (po 
BINIASC: 

SI3N bit ACC.7 

; Get the numoer/ find its sign and store its sign 
mov A/ i3Rl 
mov £R1 /£plus 



t Nex 
mo 
de 
cp 

; - c ac 

jO.ON 
in 
mo 
di 
ad 
mo 

f Fac 
in 
mo 
mo 
di 
ad 
mo 

J Sto 
in 
mo 
ad 
mo 

t not 
re 



b sicn/go - on2 

t 3 instructions han 

v S)R1/# minus 

C A 

1 A 

tor out the first di 



R1 

3/ 
63 
A/ 
3R 

>r o 
R1 
A/ 
3, 
AS 
As 
SR 

) th 
R1 
A/ 
A/ 
2R 
tha 



«100 

1/A 

ut the second d 



*10 

*zero 

1/A 

a third digit 

3 

Szer o 

1/A 

t me return tuit 



;store a plus sign (over- 
written by minus if needed) 
; test the sign bit 
die negative numbers 
/store a minus sign 



git 



/store the first digit 

igit 



/store the second digit 



/store the third digit 
hout restoring R1 



ASSEMBLY COMPLETE/ NO ERRORS FCUN0 



Figure K-l . Sample Absolute Program (Cont'd.) 
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A (accumulator), 1-12, 2-2 
Absolute segments, 1-3 
AC (auxiliary carry flag), 1-7, 1-13, 2-7 
AC ALL code address, 3-4—3-5, B-2, 

B-9-B-13 
ACC (accumulator), 1-12, 1-13, 1-14 

see also, CALL, 3-24 
LCALL, 3-69, 3-70 
ADD 

Arithmetic Function, 1-10 

A,#dafa,3-6, B-2, B-9 

A,@Rr, 3-7, B-2, B-9 

A,Rr, 3-8, B-2, B-9 

A,data address, 3-9, B-2, B-9 
ADDC 

Arithmetic function, 1-10 

A,#dara,3-10, B-2, B-9 

A,@Rr, 3-11, 3-12, B-2, B-9 

A,Rr, 3-13, B-2, B-9 

A,data address , 3-14, B-2, B-9, B-10 
Address, Data unit, 1-9, 1-10 
AJMP code address, 3-15, B-2, B-9— B-12 

see also, In-Block Jumps and calls, 2-8 
JMP, 3-59 
LJMP, 3-71 
SJMP, 3-122 . 
ANL 

Logical function, 1-10 

A,#cfara,3-16, B-2, B-10 

A,@Rr, 3-17, B-2, B-10 

A,Rr,3-18, B-2, B-10 

A,data address, 3-19, B-2, B-10 

C,bit address, 3-20, B-2, B-ll 

C,/ bit address, 3-21, B-2, B-l 1 

data address Mata, 3-22, B-2, B-10 

data address, A, 3-23, B-2, B-10 
Arithmetic and Logic Unit, 1-7, 1-10 
ASCII Characters 

in strings, 2-10,4-8 

Codes, H-l 

ASM 51 invocation, 1-4—1-6 
Assembler, 1-1 
Assembler (ASM51), 1-3 
Assembler controls, 1-1 
Assembler directives, 1-1, 4-1 
Assembler State Controls 4-1 , 4-10 
Assembly-time expressions, 2-1 
ATTRIBUTES, 7-20 

B (multiplication register), 1-7, 1-12 
Binary numbers, expressing, 2-9 
BITADDRESSABLE, 4-4- 
Bit addressing, 1-14, 2-1, 2-5—2-7 
Bit address space, 1-8, 1-9,2-6 
Bit, Data unit, 1-7, 1-9 
BIT directive, 2-1, 2-5, 2-11,4-1,4-5, 
4-10, C-l 



Bit selector ("."), 1-13,2-5 
BNF,A-1 

Boolean Functions, 1-6 
see also, ANL, 3-20, 3-21 

CLR, 3-34, 3-35 

CPL, 3-37, 3-38 

JB, 3-53, 3-54 

JBC, 3-55, 3-56 

JC, 3-57, 3-58 

JNB, 3-61, 3-62 

JNC, 3-63,3-64 

MOV, 3-79, 3-84 

ORL, 3-106, 3-107 

SETB, 3-120, 3-121 
Bracket Function, 5-9, E-l 
BSEG directive, 4-1, 4-11, C-l 
Byte, Data unit, 1-7, 1-9 



C, 2-2 

CALL code address , 3-24 

see also AC ALL, 3-4, 3-5 
LCALL, 3-69, 3-70 

call-pattern, 5-2, 5-3, 5-5 
Character strings in expressions, 2-10, 2-11, 
4-8, 4-9 

see also ASCII, H-l 
CJNE 

@Rr,#c/afa address, 3-25, 3-26, B-3, B-12 

A,%data , code address , 3-27, 3-28, B-3, 
B-12 

A,data address , code address , 3-29, 3-30, 
B-3, B-12 

Rr,#data, code address, 3-31, 3-32, B-3, 
B-12 
CLR 

A, 3-33, B-3, B-12 

C, 3-34, B-3, B-12 

bit address, 3-35, B-3, B-12 
Code Addressing, 2-1,2-7, 2-9 
Code address space, 1-8 
CODE directive, 2-1,2-11,4-1,4-3, 4-7, 

4-10 
Comment Function, 5-8, E-l 
commercial at sign @ , 2-3 
conditional assembly, 5-2 
Console I/O built-in macro, 5-18, E-l 
Control line, 6-2, A-2 
Conversion to Hexidecimal Format, 1-4 
CPL 

Logical Function, 1-10 

A, 3-36, B-3,B-13 

C, 3-37, B-3, B-ll 

bit address, 3-3$, B-3, B-ll 
CSEG directive, 4- 1 , 4- 1 1 , C- 1 
CY (carry flag), 1-13,2-7 
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DA (control) see DATE control 
DA 

Arithmetic function, 1-10 

A, 3-39, B-3, B-12 
Data Addressing, 2-4, 2-5 

on chip, 2-1 

Data address space, 1-8, 1-9 
DATA directive, 2-1, 2-11, 4-1,4-3, 4-6, 

4-10, C-l 
Data Pointer (DPTR), 1-10, 2-2 
DATE control, 6-2, 6-4, D-l 
DB (control) see DEBUG control 
DB directive, 4-1, 4-8, C-l 
DBIT directive, 4-1,4-7, 4-8, C-l 
DEBUG control, 1-3, 6-2, 6-4, D-l 
Debugging, 1-2 
DEC 

Arithmetic function, 1-10 

@Rr, 3-40, B-3, B-9 

A, 3^41, B-3, B-9 

Rr, 3-42, B-3, B-9 

data address, 3-43, B-3, B-9 
Decimal numbers, expressing, 2-9 
DEFINE, 5-2-5-7, E-l 
delimiters, 5-18—5-21 
Directives 

Assembler, 4-1— 4-12, C-l 

end of program, 4-10 

location counter control, 4-7, 4-8 

symbol definition, 4-3—4-7 
DIV 

Arithmetic function, 1-10 

AB, 3-44, B-3, B-ll 
DJNZ 

Rr , code address , 3-45, B-4, B-12 

data address , code address , 3-46, 3-47, 

B-4, B-12 
dollar sign ($), 4-2 
DPH, 1-7, 1-12 

see also Data Pointer, 2-2 
DPL, 1-7, 1-12 

see also Data Pointer, 2-2 
DPTR see Data Pointer, 2-2 
DS directive, 4-1, 4-7, C-l 
DSEG directive, 4-1, 4-11, C-l 
DW directive, 4-1,4-8, 4-9, C-l 

EA (Enable All Interrupts), 1-16, 2-7 
EJ see EJECT 

EJECT control, 6-2, 6-5, D-l 
END directive, 4-1, 4-10, C-l 
EP see ERRORPRINT control 
EQS built-in macro, 5-12, 5-13, E-l 
EQU directive, 4-1,4-4, 4-5, 4-12, C-l 
Error messages 
Console, printed at 

Fatal, 7-2 

Internal, 7-2 

I/O, 7-1 
Listing file, printed in, 7-4—7-15 

control, 7-13— 7-14 

Fatal, 7-15 



macro, 7-10— 7-12 

source, 7-4—7-10 

Special, 7-14 
ERRORPRINT control, 6-2, 6-5, D-l 
ES (Enable Serial port interrupt), 1-16, 2-7 
ESCAPE macro function, 5-9, E-l 
ET0 (Enable Timer interrupt), 1-18, 2-7 
ET1 (Enable Timer 1 interrupt), T-l 8, 2-7 
EVAL built-in macro, 5-1 1, 5-12, E-l 
EX0 (Enable external interrupt 0), 1-18, 2-7 
EX1 (Enable external interrupt 1), 1-18, 2-7 
EXIT built-in macro, 5-15, E-l 
EXTI0, 1-16 
EXT11,1-16 

extensions of filenames, 1-4 
External Data address space, 1-8 
EXTRN directive, 4-1, 4-9, 4-10, C-l 



F0, 1-7, 1-13,2-7 

function, built-in macro, 5-2 



GE see GEN 
GEN 

control, 6-2, 6-6, D-l 
general relocatable expressions, 2-16 
Generic call, 2-9 
Generic jump, 2-9 
GENONLY 

control, 6-2, 6-6, D-l 
GES built-in macro, 5-12, 5-13, E-l 
grammar, language, A-l 
GO see GENONLY 
GTS built-in macro, 5-12, 5-13, E-l 

see also DATE, 6-4 
TITLE, 6-12 



hardware, 1-6 
Hexadecimal, 2-9 



ICsee INCLUDE control 

ID AT A Directive, 2-1, 2-4, 2-11,4-1,4-3, 

4-6,4-10 
IDATA space, 2-3 
IE (Interrupt Enable), 1-7, 1-12, 1-15, 1-16, 

1-18 
IE0 (Interrupt Edge flag), 1-14, 2-7 
IE1 (Interrupt 1 Edge flag), 1-14, 2-7 
IF (built-in macro), 5-13, 5-14, E-l 
Immediate Data(#), 2-1 , 2-3 
INBLOCK, 4-4 
In-Block Jumps, 2-8 
IN built-in macro, 5-18, E-l 
INC 

Arithmetic function, 1-10 

@Rr, 3-48, B-4, B-9 

A, 3-49, B-4, B-9 

DPTR, 3-50, B-4, B-ll 

Rr, 3-51, B-4, B-9 

data address, 3-52, B-4, B-9 
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INCLUDE control, 6-3, 6-6, D-l 

Indirect addressing (@), 1-9, 2-1, 2-2, 2-3 

INPAGE, 4-4 

instruction cycle, 1-7 

INTO (InteruptO input pin), 1-15,2-7 

INT1 (Interupt 1 input pin), 1-15, 2-7 

Internal data address space, 

directly addressable, 1-8 

indirectly addressable, 1-8 
interrupt 

control, 1-15—1-17 

priority, 1-6 
invocation line, 6-1 
invocation line errors, 7-1, 7-2, 7-3 
I/O port, 1-6 

IP (Interrupt Priority), 1-7, 1-12, 1-15, 1-16 
ISEG, 4-1, 4-11 

ITO (Interrupt Type control bit), 1-14, 2-7 
1T1 (Interrupt 1 Type control bit), 1-14, 2-7 



]B bit address, code address, 3-53, 3-54, 

B-4, B-9 
JBC bit address , code address , 3-55, 3-56, 

B-4, B-9 
JC code address , 3-57, 3-58, B-4, B-10 
JMP code address , generic, 3-59 
JMP @A+DPTR, 3-60, B-4, B-10 
JNB bit address ,code address, 3-61 , 3-62, 

B-4, B-9 
JNC code address, 3-63, 3-64, B-4, B-10 
JNZ code address, 3-65, 3-66, B-4, B-10 
JZ code address , 3-67, 3-68, B-5, B-10 



Label, 4-2, 4-3 

LCALL code address, 3-69, 3-70, B-5, B-9 

see also ACALL, 3-4, 3-5 

CALL, 3-24 
LEN built-in macro, 5-16, E-l 
LES, 5-12, 5-13, E-l 
LI see LIST 

LIST control, 6-3,6-7, D-l 
listing file, 1-4 

format, 7-15— 7-17 

heading, 7-18 

literal character (*), 5-2, 5-21, 5-22 
listing file trailer, 7-21 
UMP code address, 3-71, 3-72, B-5, B-9 

see also A J MP , 3- 1 5 
JMP, 3-59 
SJMP, 3-122 

local-symbol-list, 5-2, 5-6, 5-7, E-l 
location counter ($), 2-1.2, 4-2 

symbol, 2-2 
Long Jumps or Calls, 2-8 

see also LCALL, 3-69, 3-70 

LJMP, 3-71,3-72 
LTS, 5-12, 5-13, E-l 



machine instructions, 1-1 
macro 

arithmetic expressions in, 5-11, E-3 

-body, 5-2, 5-3, 5-7 

built-in, 5«-2 

delimiters, 5-18— 5-21 

expressions, 5-10 

identifier, 5-3 

listing format, 7-15—7-18 

parameters, 5-5 

-time, 5-2 
MACRO control, 6-3, 6-7, D-l 
MATCH built-in macro, 5-17, E-l 
memory addresses, 1-8 
METACHAR built-in macro, 5-10, E-l 
metacharacter (%), the, 5-2 
Modular Programming, 1-2 
module, 1-3 

monolithic programs, 1-2 
MOV 

@Rr,#data, 3-72, B-5, B-10 

@Rr,A, 3-73, B-5, B-13 

@Rr,data address, 3-74, B-5, B-l 1 

k,Mata, 3-75, B-5, B-10 

A,@Rr, 3-76, B-5, B-12 

A,Rr, 3-77, B-5, B-12 

A,data address, 3-78, B-5, B-12 

C,bit address, 3-79, B-5, B-ll 

DPTR,#ctete, 3-80, B-5, B-l 1 

Rr,#data, 3-81, B-5, B-ll 

Rr, A, 3-82, B-5, B-13 

Kr,data address, 3-83, B-5, B-l 1 

bit address, C, 3-84, B-5, B-ll 

data address, Mata, 3-85, B-5, B-10 

data address, @Rr, 3-86, B-5, B-ll 

data address, A, 3-87, B-5, B-13 

data address, Rr, 3-88, B-6, B-l 1 

data address, data address, 3-89, B-6, B-l 1 
MOVC 

A,@A+DPTR, 3-90, B-6, B-ll 

A,@A+PC, 3-91, 3-92, B-6, B-ll 
MOVX 

@DPTR,A, 3-93, B-6, B-13 

@Rr,A, 3-94—3-95, B-6, B-13 

A,@DPTR, 3-96, B-6, B-12 

A,@Rr, 3-97, 3-98, B-6, B-12 
MPL, 5-1 

MR see MACRO control 
MUL 

Arithmetic function, 1-10 

AB, 3-99, 3-100, B-6, B-ll 



NAME directive, 4-1, 4-10, 7-18, 7-20 
NES, 5-12, 5-13, E-l 
nibble, Data unit, 1-9 
NODBsee NODEBUG control 
NODEBUG control, 6-2, 6-4, D-l 
NOEP see NOERRORPRINT control 
NOERRORPRINT control, 6-2, 6-5, D-l 
NOGEsee NOGEN control 
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NOGEN control, 6-2, 6-6, D-l 

listing format, 7-15—7-18 
NOLI see NOLIST control 
NOLIST control, 6-3, 6-7, D-l 
NOMACRO control, 6-3, 6-7, D-l 
NOMRsee NOMACRO control 
NOOBJECT control, 6-3, 6-8, D-l 
NOOJ see NOOBJECT control 
NOP, 3-101, B-6, B-9 
NOP AGING control, 6-3, 6-8, D-l 
NOPI see NOPAGING control 
NOPR see NOPRINT control 
NOPRINT control, 6-3, 6-10, D-2 
NOREGISTERBANK, 6-3, 6-11, D-2 
NOSBsee NOSYMBOLS control 
NOSYMBOLS control, 6-3, 6-11, D-2 
NOXR see NOXREF control 
NOXREF control, 6-3, 6-13, D-2 
null string 
assembler, 2-11,4-8 
macro processor, 5-2 
NUMBER, 4-10 
Numbers 

specifying, 2-9 

representation of, 2-10 

OBJECT control, 6-3, 6-8, D-l 

Object file, 1-3 

OBJHEX Code conversion program, 1-4 

Octal, 2-9 

O J see OBJECT control 

Operands # 

Operators, Assembly-time 
Arithmetic, 2-13 
Logical, 2-13 
Relational, 2-14, 2-15 
Special Assembler, 2-14 

Operator Precedence, 2-15 

Operators, macro, 5-10 

ORG directive, 4-1, 4-2, 4-11, C-l 

ORL 
Logical function, 1-10 
A,#ctera,3-102, B-6, B-10 
A,@Rr, 3-103, B-6, B-10 
A,Rr, 3-104, B-6, B-10 
A,data address, 3-105, B-6, B-10 
CM address, 3-106, B-6, B-10 
CJbit address, 3-107, B-6, B-l 1 
data address $data, 3-108, B-6, B-10 
data address, A, 3-109, B-6, B-10 

OUT built-in macro, 5-18, E-l 

OV (overflow flag), 1-7, 1-13, 2-7 



P (parity flag), 1-7, 1-13,2-7 
PAGING control, 6-3, 6-8, D-l 
PAGELENGTH control, 6-3, 6-9, D-l 
PAGEWIDTH control, 6-3, 6-9, D-l 
PC, 1-7, 1-11,2-2 
see also, program counter, 2-2 
PI see PAGING control 
PL see PAGELENGTH control 



POP data address, 3-110, B-7, B-12 
Port 0(P0) see I/O Port, 1-6 
Port 1 (PI) see I/O Port, 1-6 
Port 2 (P2) see I/O Port, 1 -6 
Port 3 (P3), 1-14 
see also I/O Port, 1-6 
poundsign (#), 2-3 
PR see PRINT control 
predefined bit addresses, 2-7 
predefined symbolic register addresses 
(AR0-AR7),4-12 
PRINT control, 6-3, 6-10, D-2 
Program, 1-3 

Program counter, 1-6, 1-9, 2-2 
Program linkage, 4-1, 4-9 
Program memory, 1-8 
Program Status Word (PSW), 1-13 
PS (Priority of Serial Port Interrupt), 1-16, 

2-7 
PSW see Program Status Word, 1-13 
PT0 (Priority of Timer Interrupt), 1-16, 

2-7 
PT1 (Priority of Timer 1 Interrupt), 1-16, 

2-7 
PUBLIC directive, 4-1, 4-9 
public symbols, 2-16 
PUSH data address, 3-111, B-7, B-12 
PW see PAGEWIDTH control 
PX0 (Priority of External Interrupt 0), 

1-16,2-7 
PX1 (Priority of External Interrupt 1), 

1-16,2-7 



R0, Rl, R2, R3, R4, R5, R6, R7, 1-11, 2-2 

see also, registers, General-purpose, 1-11 
RAM memory, 1-6 
RD (Read Data external), 1-15, 2-7 
register 

Banks, 1-11 

General-purpose, 1-11 

Program addressable, 1-12 

value at reset, 1-17 

register address symbols AR0-AR7, 2-2 
REGISTERBANK, 6-3, 6-11 
Relative Jumps, 2-8 
Relative offset, 2-8 

Relocatable Expression Evaluation, 2-16 
relocatable object code, 1-3 
relocatable segments, 2-16 
relocatable symbol, 2-16 
Relocation and Linkage, 1-4 
relocation types, 4-3 
REN (Receive Enable), 1-15, 2-7 
REPEAT built-in macro, 5-15, E-l 
Reset, 1-17 

RESTORE control, 6-3, 6-10, D-2 
RET, 3-1 12, 3-113, B-7, B-9 
RETI, 3-114,3-115, B-7, B-9 
return value, 5-2 
RL51,l-4 

RLA, 3-1 16, B-7, B-9 
RLCA, 3-117, B-7, B-9 
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RL-time expressions, 2-1 

RRA, 3-118, B-7, B-9 

RRCA, 3-119, B-7, B-9 

RS see RESTORE control 

RSO (Register Select Bit 0), 1-7, 1-11, 1-11 

2-7 
RSI (Register Select Bit 1), 1-7, 1-11, 1-13, 

2-7 
RSEG, 4-1, 4-11 
RXD (Serial Port Receive pin), 1-15, 2-7 

SA see SAVE control 

SAVE control, 6-3, 6-10 

SB see SYMBOLS control 

SBUF (Serial Port Buffer), 1-7, 1-12 

SCON (Serial Port Control), 1-7, 1-12, 1-15 

scope, 2-11 

external, 2-11 

local, 2-11 

public, 2-11 
segment, 1-2 

SEGMENT directive, 4-1,4-3 
segment type, 2-1,2-11,4-10 

attributes, 4-3 

BIT, 2-11 

CODE, 2-11 

conventions, 2-12 

DATA, 2-11 

IDATA, 2-11 

in expressions, 2-15 

of operands, 2-3—2-5, 2-8, 2-9 

of symbols, 4-4 — 4-6 

XDATA, 2-11 
Segment Selection Directives, 4-1, 4-1 1 
serial I/O Port, 1-6, 1-7, 1-15 
SETB 

C, 3-120, B-7, B-12 

bit address, 3-121, B-7, B-12 
SET built-in macro, 5-1 1 , E-l 
SET directive, 4-1, 4-5, C-l 
simple relocatable expressions, 2-16 
SINT, 1-16 

SJMP code address, 3-122, B-7, B-ll 
SMO (Serial Mode Control bit 0), 1-15, 2-7 
SMI (Serial Mode Control bit 1), 1-15, 2-7 
SM2 (Serial Mode Control bit 2), 1-15, 2-7 
source listing, 7-18 
SP (Stack Pointer), 1-12, 1-17, 1-19 

see also stack, 1-11 
Special Assembler symbols, 2-1 , 2-2 

see also EQU directive, 4-4, 4-5 
Stack, 1-11 
stack segment, 4-4 
Statement Labels, 4-2 
Storage Initialization/Reservation 

directives (DS, DB, D W, DBIT), 4-1 , 

4-2,4-7—4-9 
SUBB 

Arithmetic function, 1-10 

A,#ctete, 3-123, B-7, B-ll 

A,@Rr, 3-124—3-125, B-7, B-ll 

A,Rr, 3-126, 127, B-7, B-ll 

Kdata address, 3-128, 3-129, B-7, B-ll 



SUBSTR built-in macro, 5-16, 5-17, E-l 
SWAP A, 3-130, B-7, B-12 
symbol, 2-11,4-4 
definition, 4-1,4-2, 4-3 
names, 4-2 
see also BIT, 4-5 
DATA, 4-6 
EQU, 4-4, 4-5 
SET, 4-5 
XDATA, 4-6 
use of, 2-11,2-12 
SYMBOLS control, 6-3, 6-11, D-2 

TITLE control, 6-3, 6-12, D-2 

TO (Timer/counter External flag), 1-15, 

2-7 
Tl (Timer/counter 1 External flag), 1-15, 

2-7 
TCON (Timer Control), 1-7, 1-12 
TF0 (Timer Overflow Flag), 1-13, 2-7 
TF1 (Timer 1 Overflow Flag), 1-13, 2-7 
TH0 (Timer high byte), 1-7, 1-12 
TH1 (Timer 1 high byte), 1-7, 1-12 
TIMER0, 1-17 
TIMER1, 1-17 

TL0 (Timer low byte), 1-7, 1-12 
TL1 (Timer 1 low byte), 1-7, 1-12 
TMOD (Timer Mode), 1-7, 1-12, 1-14 
TR0 (Timer Run control bit), 1-14, 2-7 
TR1 (Timer 1 Run control bit), 1-14, 2-7 
TT see TITLE control 
two-pass assembler, 4-1 
TXD (Serial Port Transmit bit), 1-15, 2-7 
Type, 2-11 

address, 2-11 

number, 2-11 

register, 2-1 1 

segment, 2-11 
TYPE, 7-20 
typeless symbol, 4-10 
type "REG", 4-4 

UNIT, 4-4 

UPM, 1-6 

UPP, 1-6 

Use of symbols, 2-1 1 

USING directive, 2-2, 4-1, 4-12 

Value, 2-11 

constant value, 2-11 

register name, 2-11 

segment base address, 2-1 1 

symbol address, 2-11 
VALUE, 7-20 

WF see WORKFILES control 
WHILE built-in macro, 5-14, E-l 
words, Data Unit, 1-9 
WORKFILES control, 6-3, 6-12, D-2 
WR (write Data for External Memory), 

1-15,2-7 
Writing, Assembling, and Debugging an 
MCS-51 Program, 1-4 
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XCH 

A,@Rr, 3-131, B-7, B-12 

A,Rr, 3-132, B-7, B-12 

A,data address, 3-133, B-7, B-12 

XCHD A,@Rr, 3-134, 3-135, B-8, B-12 

XDATA directive, 2-1, 2-11, 4-1, 4-3, 4-6, 
4-10 

XR see XREF control 

XREF control, 6-3, 6-13, 7-20, 7-21, D-2 



XRL 

Logical function, 1-10 

A,%data, 3-136, B-8, B-10 

A,@Rr, 3-137, B-8, B-10 

A,Rr, 3-138, B-8, B-10 

A,data address, 3-139, B-8, B-10 

data address, ^data, 3-140, B-8, B-10 

data address, A, 3-141, B-8, B-10 
XSEG directive, 4-1,4-6, 4-11, C-2 
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